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August  14,  1980 


Information  Memo  No.  ID-80-147 
Expires  9/30/81 


To:  All  District  Managers 

From:  Chief,  Division  of  Resources 

Subject:  Use  of  "Hydrologic  Information  Storage  and  Retrieval  System"  -  HISARS 

We  have  now  gained  access  to  the  University  of  Idaho's  computer  facility  in 
Moscow,  Idaho,  for  use  of  the  "Hydrologic  Information  Storage  and  Retrieval  System" 
(HISARS).  The  system  is  operated  by  the  State  of  Idaho  climatologist  and  contains 
all  official  climatological  records  in  Idaho.  The  system  allows  climate  inform¬ 
ation,  such  as  precipitation,  to  be  printed  out  on  the  Districts'  computer  term¬ 
inal.  The  HISAR  System,  in  conjunction  with  internal  statistics  programs,  can 
calculate  averages,  medians,  variability,  etc.,  on  any  number  of  stations.  The 
turn-around  time  for  the  information  is  less  than  24  hours  since  the  system  is 
a  "batch"  process.  This  means  that  a  specialist  can  dial  up  the  computer,  ask 
for  specific  pieces  of  information,  then  sign  off.  After  the  request  is  processed 
at  the  University  of  Idaho's  computer  center,  it  is  placed  in  storage  until  a 
specialist  calls  up  the  computer  and  asks  it  to  print  out  the  needed  data. 


The  use  of  HISARS  should  vastly  improve  the  Districts'  ability  to  obtain  climatic 
data  and  to  summarize  it  in  a  useful  format.  We  expect  to  have  a  training  session 
on  the  use  of  HISARS  in  the  fall,  but  until  then  we  have  included  some  procedures, 
instructions  and  operational  manuals. 


Enclosures 

Enel.  1  -  Procedure  for  using  HISARS 
Enel.  2  -  U  of  I  -  Computer  Services 
Enel.  3  -  U  of  I  -  Guide  to  use  of  HISARS 


Distribution  w/o  ends. 
Director  (855)  -  2 
SCD  (D-559-A)  -  3 
Chief,  ISO-940  w/encl.  1  only 
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PROCEDURE  FOR  USING  "HYDROLOGIC  INFORMATION 


STORAGE  AND  RETRIEVAL  SYSTEM " 


1.  All  commands  to  be  entered  through  the  terminal  should  be  written 
down  prior  to  log-on  to  reduce  phone  charge  and  terminal  time. 


2.  Log-on  should  be  recorded  on  a  Telephone-Data  Circuit  Usage  Record, 
showing  date,  destination (as  Moscow,  Id.)»log-on  and  log-off  time, 
elapsed  time  under  DDD  (direct  distance  dialing)  and  USER. 

3*  Turn  on  terminal,  set  "parity”  to  4  which  ignores  incomming  parity. 
Set  "baud'1  to  300.  s 

4.  Dial  1-885-7811  to  obtain  computer.  When  tone  is  heard,  press  "data" 
button  on  telephone. 


(in  the  following  instructions  — computer  response  is  denoted  in 
CAPS  and  terminal  input  is  denoted  in  small  letters) 


after  dial-up... 

ON  AT  (TIME)  (DATE)  (DAY)  LINE# 

USER  NUMBER,  PASSWORD? 

saa _ ,ui  (THE  UI  is  the  standard  first  time  entry  password,  this  should 

(user  #)  should  be  changed  in  thenext  step) 


READY 

password  password 

fc X enter  new 
password) 

READY 


f,  X  l 


•  *f‘  »  \  #* 


■  y  •  i  £-• 


,  ,  ;  : : 


(new  password  is  1-8  characters) 

.  ..  ..  -  *$*5  -  -  t  ■  ■■  }  tWtif-V 

.f-  •  -  .*  i  .  *  4.; ..  j  v  •  ~ w.*  -•  *  ••  '  -f  -  .f 

**  ■  b-y  '  ?"  -  ,  -  .  V  - 


i  ■ 


'S  > 


,-v  i :  ,  x.  X  ■ 

\  &X-  vvV.vu 

A 


width  5i  •(WIDTH  IS  USED  TO  SPECIFY  OUTPUT  OTHER  THAN  72  characters) 


5.  Hysars  can  now  be  accessed  but  an  access  program  must  be  entered, 
next  entry  to  computer  is.... 


100  / /j jobname  job  (csblm,  -  -  ),fuser'  (see  item  12  for  default  info) 

(l-7char.)  (social  security  #) 

110  /*dest«thold  (this  holds  output  in  a  batch  remote  mode) 

120  //jobname  exec  hisars  (this  gets  hisars) 

.(jobname  from  above) 


130  access  (this  command  signals  the  beginning  of  a  group  of  command 

cards  constituting  a  single  access  request.) 

140  element  rainfall  (the  element  command  identifies  the  element(s) 

for  which  the  access  is  requested.  Element  operand 
includes  streamflow,  rainfall,  temperature,  evaporation, 
snowfall,  event,  peakflow,  and  hourrain) 

Other  basic  commands  can  be  used  for  various  information.  See  the  HISARS 
manual  for  more  detail.  Thereat  of  the  instruction  will  be  ending  commands 
and  data  retreival.  Ct*d  ^ 


6 


.  The  following  is  a  continuation  of  the  program  to  get  the  data 
that  has  been  accessed  in  the  proper  format.  For  example,  after 
accessing  the  element  rainfall  we  can  specify  a  particular  area, 
station,  county  etc. 


150  county  owyhee  (you  could  have  specified  a  station  number, 

region , location) 


(additional  commands  can  be  used  to  specify  a  period 
ofx  record) 


7. 


The  next  command  directs  the  system  to  produce  certain  listings  of  the 
accessed  data.  ’  •  ' 


...  ,i 


160  list  index  (this  would  list  and  Index  of  the  rainfall  data  and 

-  stations  in  Owyhee  county) 


Other  options  are  available  so  consult  your  hisars  manual  for  more  info. 


8.  The  final  command  or  card  should  be  a  //  to  identify  the  end  of  the 
command  programs. 


170  // 

9.  The  next  command  can  be  a  SAVE  command  or  LIST  command  or  SUBMIT 
command.  The  save  command  temporarily  saves  the  program  in  a  file 
with  a  job  name...  ’ 

1  .3  ;•  V  I  -• 

save  jobname 
READY 

The  LIST  command  would  print  out  your  program. . . 
list  jobname 
READY 


The  SUBMIT  command  would  submit  your  program  to  the  batch  processor, 
submit  jobname 
SUBMITTED  AT  (TIME) 

10.  The  nest  command  could  end  your  session  on  the  terminal  if  you  have 
subimtted  all  the  jobs  you  need  to. 


off 

OFF  AT  (TIME) 

PROC  TIME  0  SEC. 
TERM  TIME  MIN. 


(use  this  number  to  enter  on  your  telephone  log) 


. 


T 


11. 


The  next  step  Is  to  get  the  data  out  of  the  processor.  You  should 
allow  at  least  4  hours  or  preferably  a  day  before  trying  to  get  your 
data  out  of  the  computer. 

To  check  on  the  status  of  a  job  you  can  type... 


job  jjobname 

NOT  FOUND  (this  will  be  the  response  if  nothing  is  found 

in  THOLD) 


If  the  data  is  ready  tc\  be  taken  out  you  will  enter... 

scan  jjobname  (the  scan  command  -  the  jobs  output  will  enter 

the  SYSOUT  classes,  while  in  the  scan  mode 
all  other  commands  will  be  ignored  except 
clear-  gets  you  out  of  scan  mode 
find-finds  specific  strings 
list-list  all  lines  of  data  (the  listing  of 
data  can  be  interupted  by  hitting  the 
attention  key  or  break  key) 
next-moves  you  on  to  the  next  data  set 
begin-returns  you  to  the  start  of  the  job 


JCL  MSGS  SYSOUT  -A 

? 

next 

SYSPRINT  SYSOUT-A 


(this  is  input  output  info  that  will  not  include 
your  data,  computer  responds  with  a  ?) 


(this  Is  the  data  you're  Interested  In) 


list 


(computer  now  prints  the  entire  dataset) 


Other  scan  features  can  be  used  to  review  or  recall  specific 


data.  ■  r  <  i 

is'*; 

’  DATA  PRINTS  OUT 


;  .  t  -  ----- 

-  r ;  U--S3-  i 

1  -  '  1 1  ■  ■  i  '■ 


■/  .  ’  -sir-.  »*??■;  4.  >3:.  k-  ; 

'  i  CP!  is  :  8  ■  .  t-i  -■  Wi  - 

G  ;  '  -  &&& . 


? 


-r  ■  •  ‘ 


:  '  r  >•  c 

t.  - 


clear  (this  returns  you  to  the  system  mode  for  other 

commands  or  to  get  you  off  the  line) 

READY 

off 

OFF  AT  (TIME) 

PROC  TIME  _SEC. 

TERM  TIME  _MIN.  (Be  sure  to  record  and  report  your  terminal  time 

to  the  phone  record  sheet  and  to  give  your  phone 
charges  to  your  AO  so  he  knows  where  they  came 
from.  This  should  be  done  at  the  end  of  each  month) 


' 


12.  Many  other  types  of  commands  are  in  the  user  guides. 

The  job  card  can  be  altered  if  you  will  exceed  the  default  limits. 
4000  lines  is  default,  60  seconds  is  default. 

Instructions  for  the  THOLD  system  are  on  computer  type  print-outs 
in  the  back  of  the  CALL/VS  users  guide. 


If  you  have  questions  about  things  in  the  manual  or  have  trouble 

t&lking  to  the  U  of  I  computer  call: 

* 

Charlie  Rice 

or  D  OF  I 

Bill  Pyle  at  885-6721 

Tour  account  user  numbers  are  coming  to  you  under  blue  envelope. 

Do  not  exceed  $100.00  computer  +  terminal  time  without  callifig  Gebhardt 


Please  send  a  summary  of  your  activity  on  the  U  of  I  computer  each  month 
to  Gebhardt  ISO  931. 
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COMPUTER  SERVICES 

REVISED  JULY,  1976 

PRICE  $1.50 


University  of  Idaho 

Moscow,  Idaho/83843 


> 


UPDATING  FEATURE 


To  obtain  updates  for  this  User's  Guide,  please  return  the 
lower  portion  of  this  page. 


CALL/VS  USER'S  GUIDE 


SEND  TO:  User  Services 

Data  Controller 
Computer  Services 
University  of  Idaho 
Moscow,  ID  83843 


NAME  _ 

Department  _ 

Mailing  Address 
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The  purpose  of  this  manual  is  to  serve  as  a  User's  Guide  to  the 
CALL/VS  system  as  it  is  installed  at  the  University  of  Idaho.  It  is 
designed  to  acquaint  the  beginning  user  with  the  procedures  for 
obtaining  access  to  the  system,  running  programs,  and  writing  pro¬ 
grams  . 

A  WORD  ABOUT  CALL/VS 

CALL/VS  is  a  very  simple  system  to  use.  CALL/VS  is  a  rime- 
sharing  system  designed  to* run  under  the  0S/VS1  operating  system.  In 
was  designed  for  rapid  response  for  interactive  computing. 

Once  a  user  is  logged  on  the  system,  four  libraries  are  access- 

able  : 

1.  The  library  associated  with  the  user's  userid, 

2.  The  *library  (single  star  library)  —  a  library- 
shared  by  a  group  of  userids  with  common  first 
four  characters  of  the  userid, 

3.  The  ** library  (double  star  library)  —  a  library 
shared  by  all  users.  Any  user  can  place  entries 
in  the  double  star  library, 

4.  The  ***library  (triple  star  library)  —  a  library 
shared  by  all  users.  Only  the  Computer  Center 
can  place  entries  in  this  library. 

In  reality,  only  the  userid  library  and  the  triple  star  library 
are  true  libraries.  The  single  and  double  star  libraries  are  direc¬ 
tories.  They  have  entries  which  point  to  the  true  locations  of  the 
programs  or  data  files.  This  system  avoids  costly  duplication  of 
files.  This  manual  will  refer  to  the  single  and  double  star  direc¬ 
tories  as  libraries  for  consistency. 


\ 
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TEST 


15J02  04/25/80  FRIDAY 


100  // JTEST  JOB  < CSBLM r 528-80-2710 ) r "GEBHARDT" 
LOS-L*  DE.ST-THOL.D 

120  //TEST  EXEC  HISARS 
L3.0.  .ACCESS 

140  ELEMENT  RAINFALL 
JL4.5-  REGION  QA 

150  COUNTY  OUYHEE»BRUNEAU»TWIN 
■LiiO— LIST  .1 NDFX 

170  // 


S-UBULT  -XES-T 

TEST  NOT  FOUND  OR  OBJECT  PROGRAM 
SAUE  TEST 

READY 


SUBMIT  TEST 
RIIFtMTTTFTi  6T 

1  r  i  r»7 

j 

1 

SCAN  JTEST 

* 

I 

NOT  FOUND 

- , - 1 

SCAN  TEST 
unT  rnnun 

n  cr  c 

j. 

- S’ 

- Ur  r - — - 

OFF  AT  15: 04 

a  ccrr  . 

1 

f 

f 

- r  PlU-b - 1  L  - ** - 

TERM  TIME  19  MIN ♦ 


o 


c? 


o 


o 


o 


o 


o 


C 


o 


u 


VJ 


c 


L 


ON  AT  9  J  33  04/28/80  MONDAY  LINE  8 

USER  NUMBER y PASSWORD? 

BSBSBiiSBHBBIBB -  - 

READY 

SCAN  JTEST 

‘JC'L  M’S  G5  ~SY3"0'UT  =  A - 

? 

TosTfst  JOB  rxXXXXy  528-80-2710)  y  '  GEBHARDT  / 

LOG  IEF403I  JTEST  STARTED  TIME-15 ♦ 38 ♦ 45  USER=THQLD 

"LUG  IEF234E  D  1 5~A  y HSR 0 0 4~ - 

LOG  IEF533A  M  1 5 A y USR001 y y JTEST y H ISARS 

LOG  "UIM'0231 - JOB  7  J1ES  I - '  SYSUU7  =  A» - 77  RETJURUS - 

LOG  IEF404I  JTEST  ENDED  TIME=15 ♦ 41  *  18 

//TEST - EXEC  HISARS - 

XXHISARS  PROC 

00000100 - 

^  ^  )j(  )|(  jjc  *  }j( 

W(7 00200 

***  PROC  FOR  THE  HISARS  DATA  STORAGE  AND  RETRIEVAL  SYSTEM 

00000300 - 

***  MYRON  MOLNAU  y  AGRCULTURAL  ENGINEERINGy  PHONE  6182 

■00000400 - - - - - - - 

***  PROC  VERSION  OF  JANUARYyl980 

■owousou - 

»t>  iL-  d/  ^  ^  vl /  vli  ^  vL 

^  ^  ^  ^  ^  ^  ^  <r 

TTO  000600 - - 

XXHISARS  EXEC  PGM^MAIN 

00000700 - ~~~ 

XXSTEPLIB  DD  DISP  =  SHRyDSN--HISARS*JAN80 
00000800 

XXSYS  PRINT  DD  SYSOUT  =  A  _  __ 

XXQPOUT  DD  DSN  =  S8,QP  y  SPACE  ==(  30  00  y  (  10  y  10  )  )  ,  UNITED  I SK  r 
OOOOIOOO - - 

XX  DCB=(RECFM=FyBLKSIZE=3000yLRECL=3000yBUFNQ=l ) 

00001100  “ 

XXSAVE  DD  DISP*SHRyDSN*HISARS. COUNTS 

DOT)  01 200 - 

XXISNO  DD  DISP-SHRyDSN=INDEX» SNOWFALL 
00001300 - “ 

XX I  WAT  DD  DISP  =  SHR y DSN=INDEX . PANTEMP 


AAAA-I  AAA 


. 


v./  u. 


IEF285 I 


111 

^i»juvxxo«  ixuoo*tW4n. rxuo  +  oicoi  ♦  (Tr 

MOL  SER  NOS-  VS0009, 


UtLc.  rtir 


TEF285I  " 

IEF285I 

nTTS'ARS  ♦’COURT'S"''  ' 

VOL  SER  NOS-  USROOl. 

KEF T 

I EF28dT 

IEF285I 

1 N  i.i  E  X  ♦  S  N  0  W  F  A  L  L 

VOL  SER  NOS-  U S R 0 0 1  ♦ 

“KEPT - 

itr 2  8  J  I 

IEF285I 

INDEX  .l-' AN  1  EMF' 

VOL  SER  NOS-  U S R 0 0 1 . 

- KEPT - 

s 

i  b.  h  2  b  5  1 

IEF285I 

1 N  D  E  X  ♦  F‘  k  E  L I P  ♦  D  A I L  Y 

VOL  SER  NOS-  USROOl. 

KEPT - 

— - - - - 

1  fc.  h  2  b  5  i 

IEF285I 

I  in  D  E  X  ♦  F  R  E  C  I  F‘  ♦  H  0  U  R 

VOL  SER  NOS-  USROOl. 

- KEPT - 

‘  ■— 

: 

I E  F  2  8  5 1 

IEF285I 

INdEX  ♦  E  V  A  F' 

VOL  SER  NOS-  USR001 ♦ 

- KEPT 

IEF2S5T- 

IEF285I 

~TN  DE  X  7FVE  NT 

VOL  SER  NOS-  USROOl ♦ 

KEPT 

1 1 F  2  8  b  I 

IEF285I 

INDEX  ♦  A  IK  1  EflF' 

VOL  SER  NOS-  USROOl  ♦ 

“KEPT - 

1EF  2851 

IEF285I 

INDEX . S 1  REAM 

VOL  SER  NOS-  USROOl. 

KEPT 

IEF2851 

IEF285I 

INDEX  »  F'  E  A  K  S 

VOL  SER  NOS-  USROOl. 

KEPT' 

| 

I E  F  2  8  5 1 

IEF285I 

INDEX.RESVUiR 

VOL  SER  NOS-  USROOl. 

- --XEP1 — 

-  - - 

J.fc.1-  2851 

IEF285I 

HISDAfA.sNUWi-ALL 

VOL  SER  NOS-  USROOl. 

- KEPT 

' 

1 1 f  2851 

IEF285I 

H I S  D  A  1  A  .  F'  A  N  l  E  fl  P 

VOL  SER  NOS-  USROOl. 

“KEPT 

i  E  F  2  8  5 1 

IEF285I 

HISDAIA.F’RECIF'  .DaiLy 

VOL  SER  NOS-  USROOl. 

KEPT 

s 

j 

IEF285I 

?NEXT 

'  HISDATA.PRECIP.HOU 

~SYWWTWT~ 

?  L I S  T 

5YS0UT=A~ 

1 

I 

NORTH  CAROLINA  STATE 

NiV EKSTTT 

* 

*  XXX 

XXX 

X 

X  X 

X  X 

X 

* 

JJT  #  X 

X 

X  X 

X 

X 

~m  w~ 

*  X 

»1<  ^  ib  X  ^  vLf  d/ 

^  fl*  ^  ^  * 

XXXX 

XXXX 

Jf.  3^****  WWXK 

* 

X  X 

X 

X 

*  T 

1C  X 

X 

X  X 

X  X 

X 

* - * - 

sir  w~ 

X 

X  XXX 

^  ^  ^  ^  ^ 

X 

...... 

X - XT 

^  ^  ^  * 

HYDROLOGIC 

INFORMATION 

storage 

ND  RETRIEVAL  b I b 1 fc.  n 

VERSION  OF  03/01/75 

PUT? 

UN 

Z  O  HI-' IN  lYdU 

DATA 

HI  ID ♦ 

ACCESS  REQUESTED  FORJ^ 

1 

1 

fc.  L  fc  ITt  NT  “ 

REGION  - 

KHXKrHLU 

06 

UimTEFTBRWFfiTJ^TinTr 


ACTION 


requested: 

- LIST  INDEX 


-I 
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RAINFALL  STATIONS 

PAGE  1 


GRASMERE 

STATION  NO. 

10-3809 

OWYHEE  “ 

LATITUDE  42-23-00 

LONGITUDE 115-53-00 

“geog^htttT' 

OC AT I ON  BLOCK  4215-233-111 

| 

_ _  ,_j 

FUEVATTON  5T4  4 

f-  f  MSL 

REGION 

GETfiEIN - 12“ 

PERIOD  OF 

RECORDS 

LENGTH,  MONTHS 

_  J 

04/1961  “ 

06/1964 

39“ 

08/1964  - 

03/1974 

116 

GRASMERE  8  b' 

0W1  htt. 

STATION  NO. 

10-3811 

L.A  1 1 TUDE  42-16-00 

LUNG I I UDE  115-53-00 

""GEOCTmFRTtrX 

OC AT I ON  BLOCK  4215-232-114 

ELEV AT  I ON  51 30  ~ 

FT  MSL 

REGION  06“ 

~EAGTN  12“  | 

PERIOD  OF 

RECORDS 

LENGTH ,  MONTHS 

•I 

5 

04/1963  - 

06/1963 

3 

08/1963  - 

07/1966 

36 

“~0'97T 9  6  6 

07/1969 

35 

09/1969  - 

06/1972 

34 

08/1972  - 

12/1972 

5 

HOLLISTER 

TWIN  FALLS 

STATION  NO. 

10-4295 

i 

LATITUDE  42-21-00 

LONGITUDE  114-34-00 

GEOGRAPHIC  if 

DC AT  TON" BLOCK  421 4-241-341" 

1 

ELEVATION  4525 

FT  MSL 

REGION  06 

BASIN  12  | 

PERIOD  UP 

RECORDS 

LENGlH,  MON ( HS 

1 

08/1948  - 

12/1977 

353 

| 

REYNOLDS 

OWYHEE'  / 

STATION  NO.  10-7648 

- rfiTTTTJTTE - 43-T2-T0  LONGITUDE  116-45-00  GrUURAPRTC 

OC AT  I ON  BLOCK  4316-224-411 


- ELEVATION  393T  “ 

'“FT  W5L"" 

~~  REGION . "06 

— E  ASTT  "  T2 — 

PERIOD  OF 

RECORDS 

LENGTH,  MONTHS 

- 0 1  /T7S2"'~ 

“127X977 

192 

THREE  CREEK 

OWYHEE 

- STATION  NO! — 

10-9119 

LATITUDE  42-05-00 

LONGITUDE 

115-15-00 

GEOGRAPHIC 

OCATION  BLOCK  42T5-T2I - 4T4” 

j 

ELEVATION  5460 

FT  MSL 

REGION  06 

BASIN  12 

- PERIOD -OF 

RECORD'S 

LhNG I H ,  MON  I HS 

07/1940  - 

12/1943 

42 

02/1944 . -' 

12/1950  “ 

83 

02/1951  - 

07/1952 

18 

- 11/1952  -" 

~07/T759 

8T 

04/1961  - 

06/1963 

27 

08/1963  - 

1 2 /"I '977 

T73 

TRIANGLE  RANCH 

OWYHEE 

S  T  A  I 1 0  N  Nu. 

T  0-9 1 97~' 

LATITUDE  42-47-00 

LONGITUDE 

116-37-00 

GEOGRAPHIC 

Glr 1 l On  BLOCK  4216—341—232 

ELEVATION  5290 

FT  MSL 

REGION  06 

BASIN  13 

- TTRrODTTT 

K  L  C  u  k  i.i  s 

LtNGIH,  MUNlHS 

01/1962  - 

09/1963 

21 

FIND  57, OWYHEE 

lit  /1 96  3“  - 

~047T964~ 

6 

07/1966  - 

08/1966 

2 

' 


* 

IT 


■ 


3NEXT 


“END  'OF  STBOUT  CLASS 

?  L I S  T 

TJTTfiTTirS - 

WHAT? 


SYSF'RINT  SYSOUT-A 


— 


- 


-  ...  yvr* 


?FIND1/ 

SYNTAX  ERROR  NEAR  *01/* 
?FIND  1/20, TRIANGLE 


SYNTAX  ERROR  NEAR  "1/20" 

*  - g-F-I-ND  l/-20-r TR I NG _ _ _ _ _ 

"•  END-OF-FILE _ _ _ 

?  B  E  G I  N 

- JCL-ttSGS  SYSQUT- A - - - 

TNEXT 

- SYSRRINT-  SYSQUT-A - __ 

7FIND  1/20, TRIANGLE 

- T-RI  ANGLE  RANCH  - Ot'FY+HrE 

STATION  NO ♦  10-9197 


>  END-OF-FILE 

_ TBEGIN _ 

JCL  MSGS  S YSOUT=A 

■>  _ ?NEXT _ 

SYSRRINT  S YSOUT=A 
- TRI-NIL  1/70  »  OWYHEE 


GRASMERE 

1  COUNTY 

-  OWYHEE, BRUNEAU, TWIN 
ruywff 

GRASMERE  8  S 

STATION 

NO, 

10-3809 

RUYHFF 

REYNOLDS 

STATION 

NO, 

10-3811 

OWYHEE 

THREE  CREEK 

STATION 

NO, 

10-7648 

RUYHFF 

TR  T  ANRI  E  RANRH 

STATION 

NO, 

10-9119 

RUYHFF 

STATION 

NO, 

10-9197 

END-OF-FILE 

9RERTN 

' 

JCL  MSGS  SYSOUT 
TNEXT 

=  A 

ii 

SYSRRINT  S YSOUT=A 
TFINIi  .1/20 » GRASM-FRF  ,  LLSX 


SYNTAX  ERROR  NEAR  "ERE," 

RR*RPIF»P,9ft  .  RRARMFRF 

RTATTON  NO,  10-3809 

OWYHEE 

GRASMERE  8  S 

QTATTfUJ  NR.  1  0  -  3  R  1  1 

OWYHEE 

- - _________ - - - 

FNfl  RF  FTI  F 

?CLEAR 

RFATlY  - 

REF  ■  - 

OFF  AT  10J07 

PRnr.TTMF  a 

qf r  . 

TERM  TIME  34 

t - 

MIN, 

_ 

■ 

* 


- 


19 


Vi 


iU  l 


»  L_  sj  ^  >  w  *■- 


L  '■  PLANA  i  i 


>  L  0 


j  MG  JOB  OUTPUT  T G  THE  T  •  MliNALi 


.OUT 

U  D  c 
/ 


JOb 


1  5 '  CUT PUT  TC 
THE  FOLLOWING  CARO 
QEST=THOLD , PASSWCRi 


E  "TERRI  KALf  OLD '  QUEUE”  , 

THE  J  U  e  »  S T A. K T  INb  l O  C  0  L  J  >  * 


^  ' 


>  WILL 
r;;  'PL 

FC  R 
^3  HOUR  3. 

ic C t  SSARY 


JOB  *  S 

THIS 


!  n  O  C 
o  o  •. 


f  Y  ST 


M  AY 


U  ,-K 
i  -j> 


;o 


I 


KOUTE  T  Hi  e 
FA  Sc  MOTE  : 

STORAGE; 

I  F  A  NY 
TO  RE-r _ _ 

uii,  Tc,  ,  kcTR  I  EV 
CARD  MAY  BE  INCLUDED  i> 
)ER  {  IE.  »  CALL /VS,  FAST 
At  J  0  B  SUBMITTED  THR_y„ThL 
SWORD  IS  OPTIONAL.  lr  Sr 
SIEVING  THE  JOB’S  UUiPUT- 
ENGTHt  AMD  CONTAIN  ONLY 


SPOOL  DATA  $!:r 


LOST 


T 


THE  0  U  T  P  U i 
ANY 


Ci  »  I- '  • 

Ac  err  ,v 


i  A  SETS  TO  THE  J.HCJLD  S  Z  CL  .  .  „ 

!■  i u  T  I  r4 TENDER  Mb  A  Pen «•] a . ■* eN  i 
■  n  PURGED  BY  THE  SYbTtM  AFTeR 
PROBLEMS  ARE  ENCGUNT  LkeDt  I  IN AY 

AL L  uul rU I 
oCGN  A  S  P C SS I BL  fc . 
JOB  SUBMITTED  THRU' A  REMOTE 
ETC.).  IT  WILL  tit  IGNORED 
.Li'.TRAL  SUBMITTAL  WIN  D  C  W  .  T  H  t 
rXI  F  I  ED. »  IT  MUST  Bfc  SUPPL  IEO_WHc.N 
IT  MUST  BE  I  THRU  8  CHARACTER^ 
ALPHA! 4U M ERIC  CH  AR  A  CT  uR  o  . 


IH  , 


SIEVING  JOB  OUTPUT  AT  THE  TERMINAL: 


JQ3  OUTPUT  AT  TERMINAL,  USE  THE  .“_S.CA.W_  COMMAND.: 

" SC  A  N  J 03 NAM E , NU MB ER  r PA SSWL RD 
pc  i,  iobnAME”  IS  THE  JOB  1  0  bL  AN  •  .  _  ,  ,  <■*  r  v  t  we 

m  Ni  UMBER n  IS  THE  INTERNAL  Jub  NUMBE  R,  Ab  oi  7cN  B  Y  Ti 

»« JOB  STATUS”  COMMAND.  _  IF  uMlTTcb,  AND  THc 
— - - JOB  NAME  I  S  NOT  UNlwUc,  TH  t  FlRbt  JGo  LuOAitJ 


IUt>NAivte  i  •  i'N 

-PASSWORD"  islth£EreT  ievalYassword  which  WAS  OPTIONALLY 
•  _G  J.V EM  UN  T  h H  GLOBAL  ROLL T - — - 


1  THE  scan“'command  IS  SUCCESSFULLY  ENTER|D,  and  the  job; 
™$g5  jMCSYSOUTtOATA  IeUgIdER  M  T  hNTsX  '  N  A  5  X  ~ 

X^s^FSTV§;sY|oaT-^^||s^i^gijpuKgiuiGNoReo; 


ONLY 


,\T SUB-COMMANDS  MAY  BE 
AR 


I 


TH  'GET'XUT  "OF  SC  AN  MOO E T~  ONLY  _  T HE  /SC  AN  WORK 


A  R  E'A 


WILL 

RE  n Tr a  n c  n •  t d f  ^  <  I  l  /VS  WORK  SPACE  R  EM  A  I  NS  I N T  AC i  • 

ALL  UNPURGED  DATA  SETS  REMAIN  IN  THE  THOLD  QUeUE. 

Eh  STR ITT GTP; I T HI N  TH E  X U R'R'E NT” 


iU  FIND  A  SPECIF Ii 


■  X 

L‘ 
rs  rA 


‘A 


r 

O 


THERE  ARe 


ALL  LI 

,  n_  ,m_  -  TWO  PC  S  I 

COLUMNS  Tu  SEARCH, 
RA'NGF  OF'  COLUMNS 
-y  ^  ««/'*.  a  SI  rC-Ji 
MUM8ER.  NOTE:  a' 

RDS  IS  A P PRUT 
oJuSN  RAf,Gc  TO  A 
MAY  CONTAIN  ANY  Li 
EXCEPT  THE  COMMA, 
LENGTH.'  EXAMPLc? 

FIND  JO, hi 
THIS  WILL  LIST  AL, 
START! 


—  r—  /— s 

K  e  C  U  ■. 


C.  U 


S  WITH  The  STRING  to i LL  Bl  LISTED . 
TONAL  OPERANDS:  THt  RANGE  uh 

AND  THE  STR I NG  TO  SE AF Ch  FOk.  A 
INDICATED  BY  TWO  NUMbcnS  SeP^RAT>_e 
COLUMN  IS  INDICATED<  BY  JUST^A 

ITEL^KNUW  I  ES  I.  , 

'  III  MUM ,  FOR  EFF  IC  I  Ef\iOY  .  me  oiKii*U 


\ R ACT  EkS 
AND  MUST 


( I NCLUD I NG  T HE a b L ANR i , 

i  HRU  6  Cn«K ACTERS  I>- 


b 


,h  j  r 


THERE” 


L  I N  E  S  W  I  T  H 
.  IN  COLUMN 


THE  CHARACTER  STRING 
20  Ot*  I  HE  DAI  A  S  e  !  . 


T> 


LIST  ALL  LINES 

he  find  and  list 


L/M  i  A 


SET. 


, .  F  T  h  t 

fjV.4  AN  OS  MAY  ALSO  CONTAIN  Irit 


' 


' — 


■  ■ 


/ 


FOLLOW  IN G  K  G  Y  W  OR  0  C  ?  LE  A MO  S  ,  v» h  :  C H  M A Y 

AMY  ORDER: 


b! 


G I V  EM  IN 


NNM. 


TO  START  FINDING/LISTING  AT  LINE  "OWN"  FROM 
THE  START  OF  THE  DATA  SET. 


-  NNN  TO  START  FINDI NG/LISTI NG  ”NNN"  LINES -BACK  FROM 


-'VHv*'  F:  .  - 


.THE.  CURRENT  _LITJE.._ 


+  NNN 


COMPRESS 


TO  START  FINDING/LISTING  "NNN”  LINES  FORWARD 
i F Kurt  THE  L U f\ k t N T  LINt* 

TO  KlHOVc  ALL  BLANKS  Fa  CM  LINES. 


NOCOMPRESS  TO  MOT  REMO 


\!  P 


BLANKS  r R CM  LIMES 


' 


T  RU  NC  =  NNN  TO  TRUNCATE  T  H  E...L.I.NE  AFTER  jCPLUMN  "NNN”  _ 

NOT RUNC  TO  NOT  TRUNCATE  LINES. 

EXAMPLE:  FIND  10/30, SYSO  UT , TRU=72 »  + 16 , NQC 

THIS  WILL  LIST  ALL  LINES  WITH  THE  STRING  "SYSGUT” 
STARTING  IN  COLUMNS  TEN  THRU  THIRTY,  TRUNCATING'  THEM 
AFTER  COLUMN  72.  THE  STRING  SEARCH  STARTS  WITH  THE 
SIXTEENTH  LINE  FROM  THE  ONE  CURRENTLY  POSITIONED  AT. 
BLANKS  ARE  NOT  .  REMOVED  FROM  L  I NES. . . . 


EXT... 


*P  GF 


k  I  NT 


•COLUMN  RANGE,  STRING,  TRUNCATION,  AND/OR 
COMPRESSION  WILL  REMAIN  IN  EFFECT  FOR  THE  DURATION  GF 
.  SCAN.  MODE  ,  OR . UNTIL  MODIFIED. . . . ,  _ £ 

ATTENTION  KEY: 

.THE  LISTING  OF  OUTPUT  MAY  BE  INTERRUPTED  AT  ANY  TIME 

_ 3Y  HIT T ENG  T KELEI ALT ENI UN2!_C R  ’.’.BEE A.RE...KE _..IU.£. _ _ 

CURRENT  LINE  WILL  8E  TERMINATED;  ANOTHER  SCAN 
SUB-COMMAND  MUST  BE  ENTERED. 

TO  MOVE  ON  TO  THE  NEXT  DATASET  OR  SYSCUT  CLASS.  THE 
OPERAND  MAY  BE  ”DS"  FOR  THE  NEXT  DATA  SET,  OR  "SO” 

FOR  THE  NEXT  SYSGUT  CLASS. 

TO  PURGE  THE  CURRENT  DATA  SET  IDS)  ,  SYSCUT  CLASS  { SOL*.. 
OH  I  ME  L  :  :  !  i  f .  C  JUO  i  j  i  ■  u  )  .  Cjuu  L  SOMt.  i  ft  Li*  u  i  o  r  U  K  a  c.  <J  , 

IT  CANNOT  BE  RETRIEVED  AGAIN.  IF  POSITIONED  WITHIN  A 
DATA  SET  OR  SYSGUT  CLASS,  BE  SURE  TO  ENTER  "PURGE  JOB” 
IF... YOU  INTEND  . T 0  P U R 0 c  I H c ....c N T  I  RE  _  J O.B. .....  _ 

TO  PRINT  THE  CURRENT  SYSGUT  CLASS  (SC),  OR  THE  ENTIRE 


JOB  (JOB),  «f  THE  kEGUL 


AR  CckTRAL  PR I NT E! 


EG  IN 


■•  DTE  THAT  IT  IS  NOT  POSSIBLE  TO  PRINT  A  SINGLE  DATA 
SET  WITH  THE  PRINT  COMMAND.  I F  IT  IS  THE  ONLY  ONE _ 
WANTED  WITHiN  THE  SYSGuT  CLASS,  ALL.  OTHER  0*  i  A  Sc.7  o  IN 
THF~  CLASS  MUST-  BE  PURGED,  THEN  THE  SYSCUT  CLASS  CAN  BE 
PRINTED;  THE  REMAINING  DATA  SET'S!  WILL  THEN  PRINT. 

TO  RESTART  OUTPUT  SCANNING  AT  THE  BEGINNING  CF  THE 

CURRENT  SYSCUT..  CLASS  .1  SCI,  ..OR  THE  BEGINNING  Of  THE _ 

JOB  (JOB).  THIS  SAVES  YOU  FROM  HAVING  TO  "CLEAR” 

AND  RETYPING  THE  "SCAN”  COMMAND. 


OPERANDS  Fl,k  he  XT  t  PURGE,  P  R  I  ij.|  ? 

Cj M A »N \j  S  rti\L  u  P  T  I  i\  A  L.  •  i  •  Ui  *  i.  T  1  ~  #  —  *  -  —  *•  •  —  ■  — 

ON  THE  CURRENT  SCAN  STATUS.  IF  CURRENTLY  POSITIONED 
AT  A  DATA  SET,  OPERATION  IS  ON  THAT  DATA  SET  ONLY.  IF 


V/  CS  A.  '  ■*  '-  lo 

, 


, 


. 


POS  I  T  I  OMED  AT  THE  END  OF  A  SYSGUT  CL  ASS.  »  QP  FRA T  I  ON  ?  <; 

nFLTHFN  mRAT'“  Dcl^rTrS1^5*  IF  IT  I  ON  ED  AT  THE  END 
Cr  t  nE  JLo,  uP ^RATION  I ^  UN  THE  ENTIRE  JuB. 


M 


E  S  SAGES  ISSUED  BY  THE  SCAN  FUNCTION; 

. - C CM -’AND  D I  S A3  LED _ 

THE  COMMAND-!  IS  DISABLED  FOR  T  HE~rDURAfT’ON~  DUE'  TO  :A 

TnSuEpK.P?2^L^«*§SE,  y?FR„§e?v-ICES-  F?ft  INFORMATION  as 
TO  W H E ,J  THi_  COMMAND  WILi_  Be  AVAILABLE  AGAIN. 


- 

&ti.? 


SY 


it 


Hi 


_ _  NtAK 

SUB-COMMAND  OPERAND  IS  INCORRECT. 


:  ;• -  .  -  v:  -  • 

- - - - - - 


vLEY 

Vi'W 


WHAT  ‘Cl- _ ’ 

SUB'-CGMMA Np  IS  INVALID  OR  NG-T  PERMITTED.  . 

NET  FOUND 

_ -THBRJOB  WA  S_  NOT  FOUND  IN  THE  "THOLD"  QUEUE  EITHER  IT 

HAS  NO  J  YET  EX  ECU  TED ,  ‘‘DE  S  T  ==T  HOLO,'‘  W  A'S  MOTT  S'P'E  C  I F  !  EOT  I  ff 
JH|  U03TS  JCL*  OR  THE  JOB  WAS  PURGED  FROM  THE  "THOLD" 
QUEUE  BECAUSE  IT  HAD  SEEN  THERE  FOR  AT  LEAST  24  HOURS. 

'INVALID  P A S S W 0 R 0~~"  -  . - - — — - 

II  SUP?L  IED  RETRIEVAL  PASSWORD  DID  NOT  MATCH  THE  ONE 
GIVEN  ON  » HE  'W  *  UEST=n  CARu. 

•  -  -  "• *  •  *  V  •  -  •  ■  ‘  -  .  I  . 

- - - ~~-r - 


N 0  W OR K  •  S PACE  A V AIL A BLE 

JUERE  ARE  CURRENTLY  TOO  MANY  USERS  IN  '’SCAN  MODE";  TRY 
AGAIM  LATE  R.  . 


■ --H/W  -.«E  ; 


"DONA ME n  SY  S  G U T=  "C LAS S"“  '  '  . ~  : — ~ - — “ 

JUTS  INDICATES  THE  CURRENT  DATA  SET  AND  SYSOUT  CLASS 

•  U  M  I  1  UN  l.  L)  A]  » 


THIS  IS  A  PROMPT  ISSUED  WHILE  IN  SCAN  MODE.  ENTER 
A  SCAN  SUB-COMMAND. 

END- OF- F  I  L E  .  . 

THE  END  OF  THE  CURRENT  DATA  SET  HAS  BEEN  REACHED. 


END  OF  SYSOUT  CLASS. 


Ur  _S  t  U  U  t  CLASS 

THE  END  OF  THE  CURRENT  SYSuUT  C  l  A’S  S  H  AS  BEEN  "RE  ACDltD  V 
.AND  THERE  ARE  ONE  OR  MORE  REMAINING  DATA  SeTS  WITHIN  THt 
S  rSuUT  C L A -> S *  IF  ALL  DATA  SL  iS  IN  THE  CLASS  HAVE  BEEN 
PURGED  *  •  THIS  MESSAGE.  I  S  NOT  I  S  S  UED,.-.  -  _ . _ 


END  OF  JGB 

ALL  OF  THE  JOB*S  OUTPUT  CLASSES  HAVE  BEEN  SCANNED,  AND 

A . -THERE  ARE.  ON  E  OR.  MORE  R  EH  AIMING-  SYSOUT  CLASSES  .  IF 

ALL  SYSOUT  CLASSES  HAVE  BEEN  PURGED/ PR  I NTED ,  THIS  MESS  AG: 
I S  NOT  ISSUED. 

E  SYSTEM  JER.ROR  "CODE" 

AN  ERROR  HAS  OCCURRED;  SCAN  MODE  IS  NUT  TERMINATED. 
STATUS  OF  THE  DATA  SETS  WITHIN  THE  JOS  ARE  UNKNOWN. 
REPORT  THE  PROBLEM  TO  USER  SERVICES;  PLEASE  BRING  THE 
• _ T  ER MINA L  OUTPUT  LISTING. 


KNOWN  PROBLEMS: 


I  ONE: 


iGES  MADE* 


TT ENT  I  ON  KEY 
_  THE  BREAK 
■  r  F  I  NO  FUNCT 


LINE.  TO  LI 
THE  BREAK 
ISSUED.  T 
1  T  WAS'  'AT 
I  RPLEMENTE 
F ILE  COULD 
A  RGUMENT  W 
C  ON  D  I T  I  ON 
TERMINATE 


DURING  LI  ST /FIN 
KEY  MAY  5E  HIT 
WHILE  THE  Z 
THE  SEARCH 
IS  RECGGNIZ 
HE  FILE  WILL  BE 
WHEN  THE  BREAK 
D  SO  THAT  A  "FI 
BE  INTERRUPTED 


T  ON 

ST. 

KEY 


D  COMMAND 

AT  ANY  TIME  DURING  A  LIST  OR  .. 
PlT  IS  SEARCHING  FOR  THE  NizXT 
WILL  BE  TERMINATED  AS-  SOON  AS 
ED;  A  QUESTION  MARK  WILL  BE 
POSITIONED  AT  WHATEVER  L INt_ 
WAS  "R E'CC  GNI  ZED'.  TH  I  5  WAS'  '.  “  ' 
NDH  OF  A  STRING  ON  A  LARGE 


t  :  " fe. 


IF  AN  INCORRECT  STRIN' 


IF  ED 


AS  ENT 

OR" THE  FINDING 
THE  LIST  OR  FIN 


FOR E ,  ONLY  AN  END-0 E- F  I L E 
OF  THE  REQUESTED  LINE  wuULD 
D  FUNCTION- 


AVr- 


■4 


— PNT” -  «» N 0 T  FOUND'1  MESSAGE  EXPLANATION.  CHANGED 

jii.TING  JOB  OUTPUT  TG.  THE  TERMINAL: 

vnTfi rTr  ~a — m^iT”ni  TPUT  TO  TFE  lsTERPINAL  HOLD  uUcUE**  » 


' 


24  ,  ■  A;M  SUBMIT  COMMAND  INITIAL  DOCUMENTATION 

ij  8 MIT  A  JOB  THRU  A  CALL /VS  TERMINAL*. 


U3.MIT  A  BATCH  JOB  STREAM  TO  THE  OPERATING  SYSTEM,  USE  THE 
MI T"  COMMAND: 

jSU8M.LT  JrIJLEX-»EI  LE2_,.EI.L£3  ,ELLE12... _ ,  _ _ _ _ _ 


:ENN ”  IS  THE  NAME  OF  A  PROGRAM  OR  DATA  FILE  IN  THE  USER*S 
LOG.  IF  THE  FILE  IS  A  PROGRAM  FILE,  IT  MAY  BE  ANY  LANGUAGE 

L  {  8AS  I C  ,.. .  ED  RXR  AN..»._G  B _ BL7  LJ .. _ LE__T  HF  FT!  F  IS  A.  .DATA  _E1LE,  JI._ 

BE  "EXTERNAL  FORMAT11.  IE.,  WRITTEN  BY  A  FORTRAN  PROGRAM 
G  FORMAT  STATEMENTS,  OR  A  PL/ I  PROGRAM  USING  PUT  EDIT 
lEMENTS.  A  PL/I  DATA  FILE  MUST  BE  WRITTEN  AS  8  0- BYTE  LOGICAL 

RDS.  (IE.  ,  ..W.I.XH  TRAILING  B.LAN.KS.,.:^E..MEED.ED.Jl...-„.PPXIG.RAM  FOB. _ 

RAN  DATA  FILES  MAY  CONT A  IN  RECORDS  OF  ANY  LENGTH.  HOWEVER, 
Nact  THAT  IF  A  CALL/ VS  PROGRAM  IS  TO  READ  THE  FILE,  IT  MUST 


A' Hr  L- 

TH  E 


EQ£E 


FORMAT 
MILL 


OF  EACH 
_..RnS  UL.I . 


RECORD  IN  THE  FILE 


IF  NOT,  A  "FORMAT 


RECORD  WITHIN  THE  FILE  WILL  BE  SUBMITTED  AS  A  CARD  IMAGE 
IS.  UP  TO  12  FILE  NAMES  MAY  BE  SPECIFIED.  IF  MORE  THAN  ONE 

NAME . IS  .GIVEN  ,  THEY..  WJ  LL.  5.F__IR E.AT.E D . AS .  A__SJ NG-LF _ EiLJEJrOJJXE_ 

JG  SUBMITTED.  (THEY  ARE  CONCATENATED  TOGETHER).  THE  CARDS 
5G  SUBMITTED  SHOULD  REPRESENT  A  JGB(S),  AS  IF  THEY  WERE 
IriED-  ON  CARDS. 


GRAM  FILE  NAME  MAY  BE  PROCEEDED  BY  A  "  =  «  CHARACTER.  THIS 
LEAVE  THE  CALL/VS  LINE  SEQUENCE  NUMBERS  ON  EACH  LINE.  IF 
'*=«  ooES  NOT  -  PRECEED  THE  FILE  NAME,  THE  LINE  SEQUENCE 

R  {  5  DIG  US.  MAX.  I  MUM)  AND .  ONE. .  B.LAMF, IF.  _P.RE.SENT , MI  L.L  BL. . 

/ED  BEFORE  CREATING  THE  GO- BYTE  CARD  IMAGE  TO  BE  SUBMITTED, 
LA  FIlE  W  ILL  BE  PROCESSED  »AS  IS";  THERE  ARE  NO 
NCE  NUMBERS. 


T  NE 


L.  i  iH 


3ES  ISSUED  BY  SUBMIT  FUNCTION: 

(UNLESS  OTHERWISE  INDICATED,  IF  ONE  OF  THE  FOLLOWING  ERRORS 
.TS...E  NCO.UM  IFiLEEL, _ NCL.,CARD.S _ FI  LJ _ BE...  S.U  BELLIUEDULaFLH.F_SY.SXE.FUJ — 


UAND  DISABLED 

the  command  has 


p 


EN  .DISABLED  FOR  THE  DURATION  DUE  TO  SOME 


SYSTEM  P RO  3 L  EM . _ FEE.. U S £R  SEE V. ICES  X O RL_LfcJEQR MAT I.ON.AS _ J 0. 
WHEN  THE  COMMAND-  WILL  AGAIN  BE  AVAILABLE. 


!T^  ccpnp 

'  „A  N  £  X  P  ECTEGXI  L  E  N  A  ME  IS  MISS  I N  G  .0  R  T  H  ER  £ 
BLANK  I  Ft  THE.  OPERAND. 


I  S  AN.  .EMBEDDED 


1  E  ,\'A ME  EXCEEDS  5  CHARACTERS 

AN  ..ENTERED  _«EJLL£_ NAME.”  .  LS  TEG  LONG 
BE  3  CHARACTERS  OR  LESS  IN  LENGTH. 

lc  THAN  12  FILE  NAMES 

I C  C_JiANYU£XLE_.NAilES_E£RE .  TaLEBEU— 


A  V  AL  I Q  FILE.  NAME  MUST.  _ 


THFRE.  IS-. A...  EIEI T -  0 F... . 12.. 


FILE  NAMES  THAT  MAY  BE  ENTERED 

ENAME  NOT  FOUND  OR- OBJECT  PROGRAM  ...  .  .  r.T,,nr 

....  LhE  I.ND..IC AJE-D  _FJJ-.E_iiAa  uiiv  h GT  JEXIUhD, Inn C AO, L.  COGLt. 
CR  IT  WAS  FOUND  AND  WAS  A <n  OBJECT  PRUGRaM.  UlJcCT  PRCuRaMS 
CANNOT  BE  SUBMITTED. 


/* 


FIL 


£ N A M £  NOT  EXT  ER N A L  F  CRM  AT 
THE  INDICAFtD  FILE  NAME  WAG  A 
3  Y  A  FORTRAN  PROGRAM  V  ITH  FOR 
PROGRAM  WITH  PUT  fcJI.T  STATt. 
SUBMITTED, 


DATA  FILE,  BUT 

’AT  STATEMENTS, 


NT  S 


THE 


XL. 


WAS  NOT.  WRITTEN 
OP  A  PL/ I 
CAR  NUT  .  .S£_.; _ 


SYS 


'EM  ERROR 
A  SYSTEM 


»•  ,*■ . : 

A  NO 


USER 


DISK 
SERVICES 


.I/O  E  R R C R  HAS  C C C U RR*ED..»  P L E.A.S .EL.  C.QH T A CT  ~ 

BRING  THE  TERMINAL  PRINTOUT, 


INTERNAL  READER  AVAILABLE 
. .  W  H E N  __C.A L L  /  V  S_  AJ  T_E M P. I  b  D _XG_ ..SI  A R I 
INTERNAL  READER  WAS  AVAILABLE  TC 
BE  BECAUSE  ALL  READERS  WERE  BUSY 
RETRY  THE  COMMAND  AFTER  WAIT  I NG 

_.Mi: B.SAjGJE _ A.fij?£AfiS_£.fc..V ERA! _ ZJiriES  »  T  HE__.JiwJE.KNAJ — &£AQLK  S  ..MAY  ha  vc 

BEEN  STOPPED  FOR  SOME  OPERATIONAL  REASON,  SEE  USER  SERVICES 
OR  THE  LOGON  MESSAGE  FOR  INFORMATION  AS  TO  WHEN  SUBMISSION 
WILL  AGAIN  BE  ALLOWED, 


PROCESS 
PROCESSING 
FEW 


.._QJ5_._TniE.__J  Et3_j_L_KG _ 

HE  JOB.  THIS  COULD 
oinG  OTHER  JOBS, 
MOMENTS.  IF  THIS 


1ST  CAR D  IS  NOT  A  JOB  CARD 

THE  1ST  CARO  OF  THE  1ST  FILENAME  ENTERED  MUST  BE 
RECOGNIZABLE  AS  AN  OS  JOB  CARD.  IF  IT  IS  NOT,  THE  CARDS 
_ BEING  S US MLLII ED_JCARN  Q  _ PRO CESS.ED_AS,„A L'.JLO£J!L. _ 


.  . .-  '  •  .  •  .  ■  .  .  ' 

•  INTERNAL  READER  ERROR,  CODE.  XX 

ERROR  XX  HAS  OCCURRED  WHILE  A  READER  WAS  PROCESSING  THE 

_  CAROS  BEING  SU  B.M  IJ  TED,  P..L  EA  S  E  CONTACT  USER  S  ER  VICES;  __&R  I  NO 

THE  TERMINAL  LISTING.  THE  LAST  JOB  BEING  SUBMITTED  MAY 
NOT  BE  COMPLETELY  SUBMITTED.  USE  THE  M  JGBST  AT  USU  COMMAND 
TO  DETERMINE  THE  STATUS  OF  ALL  JOBS  BEING  SUBMITTED;  THEN 

_ _ N  OT i  EX .  0 P E RA JHtL_IO._ilE.QU ES.L_.CA NC.ELLJKG_.OF:  _I.HE__L.4S.I__ JQ.B _ 

PROCESSED. 


SUBMITTED  AT  HH:MM 

THE  SUBMIT  COMMAND  WAS  SUCCESSFULLY  PROCESSED; 
JE RE  SUBMITTED. 


ALL  CARDS 


■ 
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The  user  also  has  access  to  three  languages  (compilers)  and  the 
•data"  mode.  The  languages  are  BASIC#  FORTRAN,  and  PL/I.  the  FOR- 
TRAN  and  PL/I  languages  are  subsets  of  the  batch  languages.  Please 
..refer  to  later  sections  of  this  manual  for  language  restrictions. 

!  The  default  language  is  BASIC.  The  maximum  program  size  is  28,848 

. 

characters  or  about  600  statements. 

All  input/output  to  CALL/VS  is  through  the  terminal  or  the 

DIBCADBU  utility.  It  is  possible  to  have  programs  in  card  deck  form 

- 

placed  in  user  libraries.  Manipulations  of  this  sort  are  carried  by 
the  DIBCADBU  utility.  Refer  to  the  section  on  DIBCADBU  for  more 

*  .  /,  2'  H  i  *  ■ 

information. 


OBTAINING  AUTHORIZATION  TO  USE  THE  SYSTEM 


To  use  CALL/VS  a  user  must  establish  an  account.  An  account 


consists  of  a  user  identification  code  (userid)  and  an  associated 

password.  To  commence  a  terminal  session  (LOGON) ,  the  user  must 

‘  ,  •  -  - 

provide  the  userid  and  password. 

If  you  are  an  instructor,  researcher,  or  project  director, 
begin  by  seeing  the  Allocations  Analyst  in  the  Computer  Services 
main  office,  ADM  127  to  set  up  a  project  code.  You  must  have  a 
valid  Computer  Services  project  code.  Next,  fill  out  the  CALL/VS 
USER  ID  application  form.  A  copy  appears  on  the  next  page.  You 
will  be  assigned  two  user  IDs;  one  for  your  students  in  the  class 
and  one  for  yourself.  Both  the  user  IDs  will  have  the  same  default 
password  of  "UI".  The  instructor  should  establish  a  private  pass¬ 
word.  This  password  should  not  be  given  to  the  class.  The  instruc¬ 
tor's  user  ID  should  be  used  for  "pooling”  class  programs  into  the 
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libraries  for  student  use. 

Any  password  which  is  not  locked  can  be  changed  by  using  the 
PASSWORD  command.  The  command  to  change  the  password  is: 


PASSWORD  password 

where  "password"  is  the  new  password  of  1-8  characters.  The 

•  ^  7  [  '  ‘  -  ;  -  r  .  -  ... 

password  may  contain  letters,  numbers,  or  special  characters. 

Experience  with  CALL/VS  indicates  that  it  is  not  necessary 
or  prudent  for  every  student  in  a  class  to  have  a  unique  user  ID. 

„  -  ’  "X?  ‘  £  . 

It  is  suggested  that  only  a  small  number  of  class  user  IDs  be 
obtained.  It  is  possible  to  have  the  Allocations  Analyst  lock 

T  .V  •  $:  i  C  'i  ..  •;’i  ^  ■•*'!  . 

the  password  so  it  cannot  be  changed.  Discuss  your  needs  with 

■  »■  i  ...  iv.  '  ■  i  V  £>  '!  .'.i  ^  r  r*  '  S'  "t  ’  \  *  i  ’•  '  .*•  *•*•«*,  •  -  *.  ,r  .  •».  .  r'.-r  ■  .* 

the  Allocations  Analyst  to  ascertain  what  is  the  best  modus  oper- 

“  ■  » f'.  ■  j  i. 

andi  for  the  particular  situation. 

Class  files  will  automatically  be  purged  two  weeks  before 


G  ft 


•V  \*'  4 


<  ) 


the  end  of  a  semester  unless  prior  arrangements  are  made  to  keep 


them  with  the  Allocations  Analyst. 


LOGGING  ON  CALL/VS 


Call/VS  supports  two  types  of  terminals:  IBM  2741' s  and 
Teletype  type  devices.  The  2741  is  the  selectric  typewriter  type 
of  device.  Most  of  the  Teletype  (TTY)  devices  are  EXECUPORT  porta¬ 
ble  terminals.  Once  a  user  is  logged  on,  except  for  the  character 
and  line  delete  functions,  the  use  of  CALL/VS  is  the  same  for  the 
various  types  of  terminals. 
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UNIVERSITY  OF  IDAHO  COMPUTER  SERVICES 


CALL/VS  USER  ID 

Application  Form  * 

• 

Persons  desiring  to  use  the  CALL/VS  facilities  of  Computer 
Services  should  file  this  application  with-  Computer  Services  approxi¬ 
mately  one  week  before  they  intend  to  begin  using  CALL.  Upon  receipt 
of  this  application  Computer  Services  will  assign  the  CALL  USER  ID  and 
confirm  approval  by  returning  a  copy  to  the  person  whose  name  appears 
on  the  form. 

Each  person  using  CALL  must  have  a  UCS  assigned  project  code. 

This  project  code  may  be  obtained  by  filing  form  UCS  005  with  Computer 
Services. 

Computer  Services  will  assign  a  unique  USER  ID  for  each  application 
received.  The  initial  password  assigned  by  Computer  Services  will  be 
the  same  for  all  applications.  The  first  thing  a  user  should  do  when 
a  USER  ID  has  been  assigned  is  change  the  password  to  something- that  is 
known  only  to  that  user.  The  password  can  be  anything  up  to  eight 
characters  in  length  and  may  contain  special  characters  and  imbedded 
blanks.  The  user  must  remember  what  password  is  assigned  because  once 
it  is  changed  Computer  Services  will  have  no  record  of  it  and  no  way 
of  finding  out  what  it  is. 


1.  University  Computer  Services  project  code 


UlilVCi.  Oi.  LY  r j - -  -  _  .  .  •  v  1  1 

If  you  are  concurrently  submitting  form  UCS  005,  leave  item  1  blank 


r,  r  K  <>'  -  --"i  2Z~  i  x  -O  ^ 

-  -r;  V  ‘  A 


2.  Classification: 

(X)  Classroom/Education 


?  1?  £  jr "■  f  -3?, 


Number  of  Students 


as 


Xfii 


(  )  Other 


«: 


User/Instructor 


*<i  ■  .  ‘ 

-J  ft  l -Si 


3.  Principal 

4.  Department/Campus  Address  6^  Af en*otr€<- 1 **£1  Phond  TT/2— 


USER  ID  \m*\i  M 


PASSWORD 


kill 


APPROVED 


DATE  V/jo/T^ 


CONFIRMATION  MAILED 

Dkte  InZSSl  ^te  Initial 


Form  No:  UCS  055-1 

Form  Title:  CALL/VS  USER  ID  Application  Form 


Page  1  of  1 
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LOGGING  ON  A  2741 


There  are  two  types  of  2741' s:  direct  wired  and  dial-up.  If 


the  2741  does  not  have  a  telephone  with  it,  it  is  a  direct  wired 
device.  Do  the  following: 


1.  Turn  the  rocker  switch  on  the  right  side  of 
the  console  to  ON.  If  it  is  already  on,  turn 
it  to  OFF  then  ON. 

2.  Depress  the  carriage  return  key.  The  terminal 
will  start  typing. 


If  you  have  a  dial-up  2741,  do  the  following: 

1.  Turn  the  terminal  on. 

2.  Pick  up  the  phone  and  dial  7711. 

3.  When  you  hear  a  high  pitched  sound,  pull  up 
the  white  button  in  the  cradle  (or  press 
down  the  silver  button,  whichever  your  phone 
has)  . 

4.  Place  the  phone  down.  Do  not  put  the  hand-, 
set  back  on  the  cradle. 

.  '  '  .  V  '  rv*.  ;  f  jtx  4 

5.  Depress  the  carriage  return  and  the  terminal 
will  begin  typing. 

6.  Skip  over  the  LOGGING  ON  with  a  TTY  and  pro¬ 
ceed. 

;  .•  .  Ip£-t 

LOGGING  ON  WITH  A  TELETYPE 

1.  Turn  on  the  machine. 

2.  If  you  are  on  a  110  baud  (normal)  TTY,  dial 
6668.  If  you  are  on  a  300  baud  TTY,  dial 
7811. 

3.  When  you  hear  the  high  pitched  tone,  pull  up 
the  white  button  on  the  phone  cradle. 

Depress  the  carriage  return  (on  some  devices 
hold  down  the  control  key  and  hit  the  S  key) . 
The  machine  will  begin  typing. 


\ 


\ 


4. 


' 


' 


' 


* 
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When  the  machine  begins  to  operate,  it  will  type: 

ON  AR  9:55  02/09/77  WEDNESDAY  LINE  20 

USER  NUMBER, PASSWORD? 

BH8BHHS8HBBSHHB 

The  BB8BSB8  is  a  mask.  The  carriage  will  return  to  the  beginning 
of  the  mask.  Type  your  userid  and  password  separated  by  a  comma 
over  the  mask  then  hit  the  return  key. 

The  terminal  will  respond  "ready". 

You  are  now  logged  on  the  system  and  ready  to  proceed. 


RUNNING  A  LIBRARY  PROGRAM 


a 


If  is  very  easy  to  run  a  program  that  is  in  one  of  the  libraries 
To  run  a  program  called  PROG1  in  the  library,  simply  type: 
run  progl 

and  the  program  will  be  loaded  into  the  work  area,  compiled  if  neces¬ 


.'f 


!■  W&Z 


sary,  and  executed.  Remember  that  the  carriage  return  key  must  be  h: 

Sil.  ,  '  •  vis'iS  ?:r  <c.--v  t&s 


after  typing  the  line. 

If  the  program  is  in  the  single  star  library  under  the  name 
*PR0G1,  to  run  type: 
run  *progl 

If  the  program  is  in  the  double  star  library,  type: 
run  **progl 

If  in  the  triple  star  library,  type: 
run  ***progl 

If  the  program  contains  any  read- statements,  the  user  will  be 
promoted  by  the  terminal  with  a  "V"  or  a  "?".,  After  the  V  type  in 
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UPDATE  OCTOBER  1,  1975 
USE  WITH  300  BAUD  (30  char/sec)  LINES 

After  logging  on  a  terminal  which  operates  at  30  char. /sec. 

(phone  number  7811)  give  the  following  command: 

width  5i 

W 

This  command  is  necessary  to  allow  the  carriage  return  to 

coincide  in  speed  with  the .data  transfer  rate  of  CALL/VS.  This 

~\ 

t 

command  is  only  necessary  when  initially  logging  on  the  system. 

It  is  not  necessary  when  using  2741  terminals  or  10  char/second 
terminals. 

'*  v-.aofc. 


\ 
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the  data  as  per  program  specification.  NOTE:  If  the  read  is  an  edited 
read,  i.e.,  with  a  format,  it  is  necessary  to  type  in  as  many  values 

t) 

w* 

as  it  is  seeking.  For  example,  if  a  FORTRAN  program  had  the  follow¬ 
ing  statements: 


READ  (5,1)  X 
1  FORMAT  (F5.0) 

The  terminal  will  prompt  with  a  V.  The  program  is  expecting  five 
digits  to  be  typed.  If  the  number  is  not  five  digits  long,  it  must  be 
padded  with  zeros  or  blanks  before  the  return  key  is  hit. 

To  halt  the  execution  of  a  program  at  any  time,  hit  the  attention 
key  (BREAK  on  a  TTY)  on  the  terminal.  This  will  halt  execution  and 


type: 


STOP 

TIME  2  SECS. 


WRITING  A  PROGRAM 


54  4  *  - 


#4$  'ji  4 

The  CALL/VS  user  has  a  work  area  for  the  program  currently  in  use. 


The  work  area  should  be  reset  or  cleared  every  time  a  new  program  is 


an..',: 


to  be  written.  If  a  program  has  been  in  the  work  area  and  not  cleared, 

'  . .  '-I  i  >'■  fi&S'LS  £f,  %  „Q 

the  new  one  will  be  written  on  top  of  or  interspersed  with  the  old. 

' 

This  is  often  disasterous.  The  command  to  reset  the  area  is: 

:  j  ■  >  <  .  •  r  ■  >J..  ; 

clear 

Most  CALL/VS  commands  can  be  abbreviated  to  three  characters.  Thus, 
the  following  could  have  been  used: 
cle 


' 
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Often  times  typing  mistakes  are  made  when  entering  a  statement. 
For  example;  if  while  clearing  the  area  cla  was  typed  instead  of  cle 
and  the  return  key  was  not  hit,  this  could  be  corrected  by  (on  a 
2741); 


1.  backspace  to  the  point  where  the  error 
was  made, 

2.  hit  the  attention  key. 

ftjV1-  •  ■*•£' V’-.i  '<*?’•  ■'  v  *•  v  •  «*•  •  •  1- *  .  ...  •  „ 

The  computer  will  react  by  striking  over  the  bad  character  and  advanc 

w 

ing  the  carriage  one  line.  Then  continue  typing  from  that  point. 

For  example;  v 


CIS 

ear 


On  a  TTY; 


1.  hold  down  the  shift  key, 

2.  strike  the  letter  O  once  for  each  incorrect 
character  in  the  line,  and  once  for  each 
correct  letter  following  it  (including  any 
blank  spaces) . 

The  backspace  symbol  (+)  or  the  underline  symbol  is  printed  for 

'  ■  *¥  ■>.?*;■  i  -  ■’*  P\<  ■ 

each  upper  case  0.  The  user  then  types  in  the  correct  information. 

For  example;  if  the  word  FORTRAN  is  misspelled  as  FURTRAN,  it  could 

be  changed  by  typing; 


FURTRAN*"*- «-«-«-*-ORTRAN 

This  procedure  can  only  be  used  if  the  return  key  has  not  been  hit. 


\ 


\ 


- 
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If  an  error  was  discovered  at  the  beginning  of  a  long  line 
(before  the  return) ,  to  delete  the  entire  line  and  start  over  on  a 
2741: 

1.  hold  down  the  shift  key, 

2.  strike  the  letter  J, 

3.  hit  the  attention  key. 


mm 


This  will  cause  the  computer  to  type  DELETED  and  forward  space  the 
carriage  one  line.  Then  retype  the  line. 

On  a  TTY: 

_ — — ""  r- 

'  1.  hold  down  the  CTRL  (control  key) , 

2.  strike  the  letter  X. 

The  system  prints  out  the  word  DELETED,  ends  the  line  autonatically 
and  forward  spaces  the  carriage. 

Knowing  how  to  correct  typing  mistakes,  a  program  can  now  be 
written.  Since  most  of  our  users  know  FORTRAN,  the  example  will  be 
in  FORTRAN.  The  same  methods  are  used  for  PL/I  and  BASIC. 

Remember  that  the  default  language  is  BASIC;  therefore,  to  writ.; 
in  FORTRAN,  we  have  to  type: 
enter  fortran 

i 

FORTRAN  could  have  been  abbreviated  fort.  For  PL/I  type: 
enter  pl/i  no  abbreviation 


For  BASIC  type: 

enter  basic 
or 

enter  basicl 


(short  form  arithmetic) 


(long  form  arithmetic) 
If  data  were  being  inputed  type: 
enter  data 


\ 


t 
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If 


, 
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After  a  mode  is  entered,  the  system  will  stay  in  that  mode  until 
a  new  mode  is  entered  or  a  program  with  a  different  language  mode  is 
loaded.  Entering  a  different  language  does  not  clear  the  work  area. 

If  a  FORTRAN  program  was  in  the  work  area  and  the  mode  was  switched 
to  BASIC,  the  FORTRAN  program  would  remain  in  the  work  area  and  the 
BASIC  program  written  on  top  of  it  with  unpredictable  results. 

Remember  to  clear  the  work  area  before  starting  something  new. 

Before  beginning  the  program  the  library  should  be  checked  to  see 
what  is  in  it  and  what  program  names  have  been  used.  To  see  what  is 

■'  i  W'  ^  ,  7 •  ‘  •  •I'--  17"  •  ’ 

in  the  library  type: 

cat  (abbreviation  for  catalog) 

The  response  is: 

9:15  04/22/74  TUESDAY 

CWR1  CWR50 


art  ir. 


X\*£  ^  V 


CWR1  and  CWR50  are  names  of  programs  or  data  files  in  the  useric 

* 

library. 

•  F*  •»  '*—  •  —  1..  |  • 

Every  program  or  data  statement  in  CALL/VS  is  entered  with  a  lire 
number.  This  line  number  is  used  to  reference  and  order  the  state- 
ments.  It  has  no  meaning  in  the  program  itself  (except  for  BASIC) . 

Begin  writing  the  program  by  entering  a  line  number,  then  one 
blank  space  and  the  statement.  For  example: 


10  x=0 

Continue  the  program 
10  x=0. 

•20  do  5  i=l , 10 
30  x=x+5. 

40  write  (6,*)x 
50  5  continue 

60  end 


\ 


' 
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Note  the  statements  are  free  form.  It  is  not  necessary  to  tat  zr 
space  to  column  seven.  The  line  numbers  do  not  have  to  be  in  even 
increments.  The  only  requirements  are  that  the  line  numbers  be 
unique,  positive,  and  in  ascending  order  to  provide  the  proper,  s eq-~~~z 
of  construction.  They  do  not  have  to  be  entered  in  order  as  the  sy's.sa 
will  sort  them  into  ascending  order  before  they  are  compiled.  Thi= 
allows  the  user  to  enter  "forgotten"  statements  in  the  program  by 


'■  ■  ■  rv 


assigning  them  a  line  number  that  would  put  them  in  the  proper  orc^r. 

/  '  ’if"'  '•  'v»\l  ■  O'fe  i.--4  •  ;  #if  i: 

Gaps  should  be  left  in  the  sequence  numbers  for  entering  additional 


.  *v  f  t "t  .  i®  '  7  '-  *• 


statements  if  necessary. 

To  compile  and  execute  the  program  type: 
run 


J  .  .-4.  *4. 


result  is: 

»  —  ,  .  -1  .. 

.  -  ;•  ■  .e:  -v  -.V  •»' 

■■  . . <>  ■ fi- .;  <•  J->JL 

9:17  04/22/75  TUESDAY 

ton  » £  4i  ^ 

5. 

10. 

•  .«?/&&«  iplj 

15. 

-  , 

20. 

..  ] 

25. 

■ 

30. 

•  •  '  C,*  p. 

35. 

40. 

-  i"  v .  *  e  ?.  t  ;i  fi  *5  ijarS* „f  id 

45. 

i  ir-  • 

rw* . 


<■**■’*  •  •  <■'2$*:*' 


S  i  i  w 


50. 

STOP 

TIME  0  SECS. 


SAVING  AND  STORING  PROGRAMS 

Once  a  workable  program  is  in  the  work  area,  it  may  be  saved 
future  use.  To  save  the  program  type: 

SAVE  progname 


1 
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where  progname  is  the  name  given  the  program.  To  save  it  giving  it 

II 

the  name  "trial"  type: 
save  trial 

To  see  the  result  type: 
cat 

9:17  04/22/75  TUESDAY 

CWR1  CWR50  TRIAL 

The  program  is  now  saved  in  source  form.  The  command  SAVE  will 
place  the  program  in  the  work  area  into  the  library  in  source  form. 

If  it  is  desired  to  place  it  in  the  library  in  object  form,  the 
command  STORE  would  be  used  e.g. 
store  trial 

This  command  would  place  TRIAL  in  the  library  in  object  form. 

It  is  important  to  note  that  it  is  not  possible  to  STORE  and  SAVE  the 
same  program  using  the  same  name.  That  is  to  say,  TRIAL  could  not 
exist  in  the  library  in  both  source  and  object  form  with  the  name 
TRIAL.  If  it  is  desired  to  have  both  source  and  object  stored,  then 
one  of  them  must  be  given  a  different  name.  For  example;  if  TRIAL 
was  in  the  work  area  and  was  saved  with  the  command: 
save  trial 

It  could  be  stored  by  issuing  the  command: 
store  trialo 

giving  it  the  name  trialo  (or  any  other  name) . 

\ 

\ 

\ 


i 
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A  program  can  be  removed  from  the  library  by  purging  it. 
The  command  is: 

purge  trial 

This  command  will  remove  TRIAL  from  all  the  libraries. 


EDITING  PROGRAMS 

It  is  easy  to  edit  programs.  To  edit  the  program  TRIAL  if  it  is 
not  in  the  work  area  type: 
load  trial 

-  . 

This  command  will  cause  TRIAL  to  be  loaded  into  the  work  area. 

*  '  i 

H  Jf'*  •  ;.!  *'?  ...  *  V  . 

Only  source  programs  and  data  files  created  from  the  terminal  in  data 
mode  can  be  loaded. 


LIST 

■.  ''  :  j  ' 

Once  the  program  has  been  loaded,  a  listing  of  the  program  can  be 


obtained  by  typing: 


list 

TRIAL 


10:43  04/22/75  TUESDAY 


10  X  =  0. 

20  DO  5  I  =  1,10 
30  X  =  X  +  5. 

40  WRITE (6,*)  X 
50  5  CONTINUE 
60  END 


Y  MIS : 


t  \  A  r. 

%  .■*  \  r  ' 


t  V 


\ 


■ 


' 


a  os 
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-i 


.  ....  »  ■  ■' .  -  S  ■  5  {  j 

The  listing  of  a  program  can  be  interrupted  at  any  point  by 


To  list  the  program  without  the  header  line,  type: 

3*x©w  ai 


depressing  the  attention  (or  break)  key.  A  listing  can  be  started 

■Si.  -k..  ... 

at  any  point  in  file  by  adding  a  line  number  to  the  LIST  command. 
For  example : 

liBt  30  aari-as. 

would  cause  the  typing  to  start  with  line  30. 


.  -  : 


list-n 


’  ;■ ' .tv’.;' -V.;.v 

;  rnV:.-\'y-  * 


b;jO\ 


which  stands  for  list  no  header.  To  obtain  a  list  without  a  header 

■’  *SJ“”  ■  ‘  ' -1  w-i.j.  Xixw  bimo«oo  i?» rrt'f 


or  line  numbers  type : 


2  i.-.  '■ft  J  1. 1  •es33.,spcii<|  .VC  £ 

list-nt  or  list-tn 

1  trc  Kso  -a&dm 


DELETING  LINES 


;  ^ 


■  PHHP .  H 

line, can  be  deleted  by  typing  in  the  line  number  of  the  state- 

.  .«*—  -  u  •• — h.  •*•-•»-'  — -w  -»-•  *  .  i.  fetfNfyJtter f - jHptlfin  '<&&********  .-a##--*  .^a*****^ 


sent  to  be  deleted  and  hitting  return.  For  example: 


M&n  Mm  a  w$*&-  g 

rr:  ‘  ' 


#  -#*r. 


.  ‘>V  -fO  ;T: 


.  list 

- 

\» ;  ^  i  *nv«  ' 

■  ■■ 

TRIAL 


•• 

T  'v  ■>  :•■  ■■■■ 


20  DO  5  I  *=  1,10 
30  X  e  X  +  5. 

40  WRITE (6 ,  *)  X 
50  5  CONTINUE 
$0  END 


it 

ail 

' 

■ . 

» 

-  *■  X 

€1,1  «;'t 

■3  »- •.  - 

0.S 

.  ?.  ^  ; 

0  v 

X  {>,*}: 

'r  /'  V 

M  I* 

r:t'  »' 

Cf  V.'-  r  « 

£ ''  •-  ^ 

1  '  '*r 

>*;  - 

•  f.  .-T-  -,-vX-f  : 

•  >  if-  •  ";i  Jk!f®.  :Jte 

' 

"  *v 


"txV.; 


■y? 


QK3 

If  is  possible  to'  delete  more  than  one  statement  at  a  time  by 
using  the  command  DELETE  (del).  The  command  takes  the  form: 

DELete  line  number, line  number,... 

For  example : 

del  20,30 


V  C  I  I 
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would  cause  the  statements  having  line  numbers  20  and  30  to  be  delete!. 
A  group  of  line  numbers  can  also  be  deleted.  The  general  fcrm  of  -the 
command  is: 

DELete  line  number  THRU  line  number,... 

For  example : 

del  20  thru  50 

would  cause  the  statements  having  line  numbers  20  through  5'  to  be 
deleted.  THRU  can  be  abbreviated  as  T. 

w 

U  m  >  *■  y1'-  ,  •’"•••  •  "  <  V..  i 

del  5,  20  T  50,  80 

'  a :  ;  ■  •  • 

would  cause  statements  having  line  numbers  5,. 20  through  50,  and  SO 

i 

to  be  deleted. 


ADDING  STATEMENTS 

To  add  new  statements  type  the  new  line  number  and  then  the 

V  !••%***  v  p.,  ^  , 

statement.  For  example,  in  the  program  TRIAL  10  x=0  had  been  deleted. 
To  put  back  the  statement  giving  it  statement  number  5  (it  could  have 
been -10) ,  type: 

5  X  =  0. 
list-n 
5  X  =  0. 

20  DO  5  I  =  1,10 
30  X  =  X  +  5. 

40  WRITE (6,*)  X 
50  5  CONTINUE 
60  END 


Statements  can  be  added  to  the  program  by  typing  in  the  new  state¬ 
ments,  giving  them  statement  numbers  to  fit  in  the  proper  p-3ce  in  the 
program.  For  example: 


' 
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8  q  =  0. 

35  q  =  q  +  x  **2 
55  write  (6,*)  q 


list 

TRIAL 


11:22  04/22/75  TUESDAY 


5  X  -  0. 

8  Q  =  0. 

20  DO  5  I  =  1,10 
30  X  =  X  +  5. 

35  Q  =  Q  +  X  **2 
40  WRITE (6 ,*)  X 
50  5  CONTINUE 
55  WRITE  (6,*)  Q 
60  END 


'J. 


Pit 


Oc  i$m 0£  ■j'sij  - 

tl,  $  hii SC-W 

.Kf&  USEl 

m  t  M  &  X&i 

‘f  '  -nSMtvxj  z-t&  nxz*.  y  L  Cif-vsr 


To  run  the  newly  edited  program  type 


:*  T  .  |C  ■ 


run 


TRIAL 


:  liiij:  1  ¥,* 


^rt-T  w&i.  of 


5. 

10. 

15. 

20. 

25. 

30. 

35. 

40. 

45. 

50. 

9625. 

STOP 

TIME  0  SECS. 


11:23  04/22/75  TUESDAY 

ir„.  ■  -u  ssmmmsn  <0 


ft  t  bfi  ■  «fM?d 

I  f: 

'**  1  lit 


31  *i 


SM  • 

I  r  OC  f*:f 
€  +  X  -  X  Ot 
■'  •  :: }  X  T  £  K  X  o  I1 

X  '•  ?  i>-  T-  O**:'*  ■;  T-;  ■*$  r,  -J 

Jh  .v.  1 4-..?  >  *  £*  c 


Remember  the  saved  program  has  not  been  altered  in  the  library. 

To  save  the  changes,  give  the  SAVE  command.  Since  the  program  already 

has  a  name,  type: 


save 


If  SAVE  command  is  given  and  the  program  does  not  have  a  name,  the 

; 

system  prints : 

FILE  NAME — 

Then  enter  the  program  name. 

While  inputting  a  long  program,  it  is  a  good  practice  to  issu 
a  SAVE  command  periodically  to  avoid  losing  work  if  the  system  go- 
down. 

|  ADD 

To  add  data  to  the  end  of  a  statement  use  the  ADD  command. 

If  statement  10  looked  like: 

10  x=0 

and  it  was  desired  to  add  a  decimal  point  at  the  end  of  the  line 
type: 

add  10,'.* 

~  •  **  i  Wwfi.*  ■-„+•>  _  -J,  ~  ;  .  V.  ti  ft  *•-  -t,  ■  \  .  T  •«  „t  . 

Statement  10  would  then  look  like: 

,  v. 

10  x=0 . 

The  general  form  of  the  ADD  command  is : 

ADD  line  number, line  number — ,' string' 
or 

ADD  line  number  T  line  number . . . , ' string ' 
or 

ADD  ALL,' string' 

where  'string'  is  the  set  of  characters  to  be  added  to  end  of  the 
.  line  (s) . 


\ 

\ 
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STATEMENT  CHANGES 

Changes  can  be  made  in  a  statement  in  either  of  two  ways:  1) 

_  retype  the  line  number  followed  by  the  statement,  or  2)  use  the 
REPLACE  command.  Remembering  the  original  program  TRIAL: 

5  X=0. 

20  DO  5  1=1,10 
30  X=X  +5. 

40  WRITE (6,  *)  X 
50  5  CONTINUE 
60  END 

To  change  the  DO  LOOP  to  15  iterations  instead  of  10,  the  state- 

. 

ment  could  be  changed  by  typing: 

20  DO  5  1=1,  15 

Since  this  statement  has  the  same  line  number  as  an  existing 
statement,  it  replaces  the  original  statement.  Remember  that  a  SAVE 
must  be  issued  before  the  version  saved  in  the  library  is  changed. 

If  a  statement  is  long  or  changes  in  more  than  one  statement  at 
a  time  are  to  be  made,  use  the  REPLACE  command. 

The  general  form  of  the  REPLACE  command  is: 

REPlace  line  number, line  number ...,’ stringl 1 ,' string 2 ' 
or 

REPlace  line  number  THRU  line  number ,' stringl 1 ,' string2 ' 
or 

REPlace  ALL, ' stringl ' , ' string2 ' 

The  command  causes  each  occurrence  of  the  first  character  string 
to  be  replaced  by  the  second  character  string  in  the  range  of  line 
numbers.  If  the  second  string  is  not  specified,  the  first  string  is 
deleted  each  time  it  is  found. 


■  ■ 
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To  change  the  DO  LOOP  index  type: 

rep  20, '10' , '15' 

The  system  would  respond 
REPLACED  1 

because  only  1  occurrence  of  '10'  was  detected  in  line  20. 


FIND 

Often  times  it  is  desired  to  locate  or  find  the  occurrences  of  a 

particular  data  element.  This  can  be  done  by  using  the  FIND  command. 

1- 

FINd  line  number, line  number string '  £, NOTEXt] 
or 

FINd  line  number  THRU  line  number ,...,' string '  J7n0TEXi] 
or 

FINd  ALL,* string'  £ NOTEXt] 

The  NOTEXT  option  means  that  only  the  line  numbers  will  be  printed. 

No  text  will  be  given. 

To  see  if  any  WRITE  statements,  for  example,  appeared  between 
line  numbers  100  and  200,  type: 


1  k  : 


>  Of- 


fin  100  T  200,'write' 

The  system  would  respond: 

110  WRITE (6,*)  x 

180  WRITE (6,100)  Z,Q,P 

To  find  all  instances  of  WRITE  statements  but  suppress  the  print¬ 
ing  of  the  text  of  the  statements  type: 

fin  all, 'write' ,n 
The  response  would  be: 

110  180  220  350 

^■Throughout  this  manual,  optional  parameters  will  appear  in 
brackets  i-.e. ,  £,parmj. 


' 
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EXTRACT 


OTHER  EDIT  COMMANDS 


This  command  is  used  to  extract  one  or  more  lines  from  a  pro¬ 
gram.  The  lines  that  are  not  extracted  are  deleted.  This  command  is 
the  logical  opposite  of  the  DELETE  command.  The  general  form  is: 

EXTRACT  line  number , line  number , . . . 
or 

EXTRACT  line  number  THRU  line  number,... 
ext  40  T  85  - 


INSERT 


v 


This  command  is  used  to  insert  a  specified  line  in  the  program 
currently  in  the  user  work  area.  The  text  enclosed  in  the  single 
quotes  is  assigned  a  line  number  specified  in  the  INSERT  command  and 
is  inserted  in  numerical  sequence  within  the  current  program.  If 
multiple  line  numbers  are  specified,  the  new  line  number  is  inserted 
repetitively.  The  general  form  is: 


1  , 


INSert  line  number, line  number ,...,' text-of-line ' 
ins  15, 'read (5,*) x' 


MOVE 

This  command  extracts  the  single  line  or  group  of  lines  indicated 
by  the  second  parameter  of  the  command  from  their  current  location. 

It  moves  them  to  the  position  immediately  following  the  position 
indicated  by  the  destination  line  number.  If  an  increment  is  specified, 
the  moved  line  or  lines  are  renumbered  using  the  same  increment  but 
only  as  necessary  to  prevent  overlapping  of  line  numbers.  If  no 
increment  is  specified,  a  default  of  1  is  assumed.  The  general  form 


is: 


\ 


f 
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MOVE  des tin- line-number , line  number  increment^ 
or 

MOVE  destin-line-number,line  number  T  line  number  H  increment 
mov  15,50 


NAME 


This  command  is  used  to  assign  a  program  name  to  a  prcrram  in 
the  work  area.  If  the  program  already  has  a  name  it  will  be  renamed 
The  form  of  the  command  is: 

W 

NAME  progname 

nam  newtrial 


RENUMBER 


\ 


This  command  is  used  to  renumber  program  lines.  The  new  line 
number  is  assigned  to  the  line  previously  identified  by  the  old  line 
number.  All  subsequent  lines  are  renumbered  using  the  increment 

2  * ;  i  T?'  ;yC  t  -  ..  .  , 

specified.  Renumbering  cannot  cause  any  lines  not  included  in  the 


tit 


renumbering  operation  to  be  overlapped. 

X-  "  >'■■’■  *  :  '  ft*  •  .  _ 

One,  two,  or  all  of  the  parameters  may  be  omitted.  Defaults  of 
100,  0,  and  10  are  assumed  for  the  new  line  number,  old  lire  number, 
and  increment,  respectively.  A  comma  must  be  used  to  indicate  an 
omitted  parameter  if  any  specified  parameters  follow. 

The  general  form  is: 

RENumber  new-line-number , old-line-number , increment 
ren  500,100,5 

USING  SUBPROGRAMS 

There  are  two  ways  to  use  subprograms  under  CALL/VS  1)  write 
them  directly  attached  to  the  main  program;  or  2)  write  them  as 


I 
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separate  programs,  save  them,  and  MERGE  them  with  the  main  program  at 
run  time. 

Using  the  first  alternative  the  program  and  subroutines  would 
look  like  one  source  deck.  For  example: 

10  x=o . 


1000  END 

1010  SUBROUTINE  ONE 


1080  RETURN 
1090  END 

1100  SUBROUTINE  TWO 


1250  END 


To  follow  the  second  option  or  to  use  subroutines  in  one  of  the 

.  _ 

libraries,  the  merge  command  is  necessary.  The  general  form  is: 

MERge  main-program, subprograml  line-number-before-insertion] 
£,  subprogram2j^J,  line-number-before-insertioi^ .  .  . 

This  command  is  used  to  incorporate  one  or  more  source  programs 

into  a  main  source  program.  The  first  subprogram  is  inserted  into  the 

main  program  after  the  line  identified  by  the  first  typed  line  number, 

the  second  after  the  second  line  number  and  so  on.  If  a  line  number 

is  not  specified,  the  subprogram  is  inserted  at  the  end  of  the  main 

program. 

The  size  of  a  program  created  by  the  merge  cannot  exceed  the 

i 

maximum  program  size  (600  source  statements  or  28,848  characters, 

whichever  comes  first) . 

/ 


-23- 


Any  source  programs  available  to  the  user  can  be  merged  as  loziz 
as  they  are  in  the  same  language.  They  may  be  in  any  available 
library.  The  subprograms  must  be  in  source. 

To  merge  a  program  type: 

mer  main, *one, two, ** three 

This  would  retrieve  the  subprograms  *one,  two,  and  ** three  and 
add  them  to  the  end  of  the  program  called  MAIN.  This  collection  of 
programs  would  be  loaded  into  the  work  area.  To  execute  type: 
run 

When  writing  a  series  of  subprograms,  remember  to  clear  the  vcr> 
area  after  each  one  is  saved  or  you  will  be  writing  on  top  of  the 
one  currently  in  the  work  area. 


DATA  FILES 


L>1  ii>  i' 


Data  files  can  be  created  in  one  of  three  ways: 


1. 

2. 


Enter  the  data  from  the  terminal  with  the  mode 
of  data. 

J  jAfl.  »Ok-  jD&CL*  t. 


Create  a  file  with  the  FILE  command  and  fill 
the  file  with  output  from  a  program. 


3.  Enter  the  data  file  on  cards  using  the 
DIBCADBU  utility. 


Data  files  created  from  the  terminal  in  the  mode  of  data  or 
by  using  the  DIBCADBU  utility  will  have  line  numbers.  Only 
data  files  with  line  numbers  can  be  edited  using  the  CALL/VS 
edit  comands.  Data  created  by  method  2  above  will  not  have 
line  numbers  and  therefore,  cannot  be  edited  by  CALL/VS  edit 
commands. 


r 


. 

m 


1 
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CREATING  DATA  FILES  FROM  THE  TERMINAL 

To  begin,  enter  the  data  mode  by  typing: 
enter  data 

To  clear  the  work  area  then  type: 
cle 

After  the  system  responds  "ready",  begin  entering  the  data  by 
first  typing  the  line  number,  leaving  a  blank  space,  then  typing  the 
data  in  the  desired  format 7 

§$ 

10  15.5  10  12.5 
20  25.2  8  25.9  v 

etc . 

The  line  number  is  not  part  of  the  data.  It  is  used  to  reference 
a  data  record.  Once  the  data  is  entered,  save  the  data  giving  the 
data  file  a  name. 

save  datal 

'  *  •  '  v:  1  -  ,  ,  •  »  '  * 

-  •  j..V_  4  f?  -  •  - 

To  later  edit  the  data,  bring  the  data  file  into  the  work  area  by 
issuing  a  load  command: 
load  datal 

.* : : X  7  : 1  \  if .  ‘  ^  /  ..  r  . 

Then  edit  the  data  using  the  same  edit  commands  used  to  edit 
programs.  Data  created  from  the  terminal  in  this  manner  is  called 
program-data . 

CALL  OPEN  AND  CLOSE  STATEMENTS  FOR  FORTRAN 

To  associate  a  data  file  with  a  program,  use  CALL  OPEN  and  CALL 
CLOSE  statements.  In  FORTRAN  the  CALL  OPEN  statement  looks  like: 

CALL  OPEN  (n, 'filename' , ’INPUT'  or  'OUTPUT') 

c*  * 


\ 


f 


where  n  is  the  device  code  for  the  read  or  write  statement,  *file-=ne' 
is  the  name  of  the  data  file,  and  *  INPUT'  or  'OUTPUT'  depends  on 
whether  the  file  is  an  input  or  output  file. 

Once  datal  has  been  created  it  can  be  accessed  in  a  program.  Jtr 
example : 

10  CALL  OPEN  ( 8 , ' DATAl ' , ' INPUT ' ) 

‘  20  DO  5  1-1,10 

30  READ  (8,100)  X,M,Z 
40  100  FORMAT  (F4 . 1 , 13 ,F5 . 1) 

50  WRITE  (6,101)  X , M , Z 

60  101  FORMAT  (  "  ,F4 . 1 , 5X, 13 , 5X,F5 . 1) 

70  5  CONTINUE 

80  CALL  CLOSE  (8) 

90  END 


Line  number  10  is  the  CALL  OPEN  statement.  It  indicates  the-:  zze 
file  is  to  be  read  with  device  code  8  (the  device  code  can  be  an 
integer  variable)  ,  the  filename  is  "datal”  and  it  is  used  as  an  ir.rtt 
file  • 

The  CALL  OPEN  statement  opens  the  file  and  positions  the  point  it 
at  the  beginning  of  the  file. 

Line  number  80  is  the  CALL  CLOSE  statement.  It  is  of  the  fcrr 
CALL  CLOSE  (n,m...)  n,m,...are  device  codes. 

The  CALL  CLOSE  statement  closes  the  file.  It  cannot  be  access  it 
again  until  a  CALL  OPEN  is  issued.  Remember  to  close  all  files  th.it 
have  been  opened,  a  maximum  of  4  data  files  can  open  at  any  one  tint;. 


V 

\ 


1  u$m 


-26- 


PROGRAM  CREATED  DATA  FILES 


L 


This  type  of  data  is  probably  the  most  commonly  used.  Create 
the  file  itself  with  a  FILE  statement  of  the  form: 

FILe  filename^n^ 

rfhere  filename  is  the  name  to  be  associated  with  the  data  file  and  n 
s  the  maximum  number  of  disk  storage  units  to  be  associated  with  the 

jj  -  .  '*$  |  f\  ?  fa  ^  r'/’-  .v";*  f*  i- 

file.  Storage  is  allocated  to  a  file  in  terms  of  storage  units.  A 

*■?  If  \z>  ft  j*  *».  >,  ■% 

storage  unit  is  3440  bytes  (characters) .  If  n  is  not  specified  in  th* 
PILE  statement,  the  default  is  4  storage  units.  The  number  of  units 
leed  not  be  specified  at  creation  time  as  long  as  4  units  is  suffi¬ 
cient.  As  the  file  grows,  the  FILE  statement  can  be  used  to  increase 
the  number  of  units  allocated  to  a  particular  file.  For  example: 
fil  data50,10 

After  the  file  is  created,  data  can  be  put  into  it.  The  follow¬ 
ing  program  places  data  into  the  file,  closes  it,  opens  it,  and  reads 


It: 


10  CALL  OPEN  ( 9 ,  ' DATA50 ' , ' OUTPUT ' ) 
20  DO  5  1=1,10 
30  WRITE  (9)  I 
40  5  CONTINUE 

50  CALL  CLOSE  (9) 

60  CALL  OPEN  (9, 'DATA50' , 'INPUT' ) 
70  DO  55  1=1,10 
80  READ  (9)  J 
90  WRITE  (6,*)  J 
100  55  CONTINUE 

110  CALL  CLOSE  (9) 

120  END 


!» <t  l ; 


MS 


■ 

V  '  '  ■  ■ 


— 


f  ^  f.  *  •  -  -•  •  '  '  •'!  ■- 
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This  program  opens  the  file  that  was  previously  created  named 
"data50".  It  associates  it  with  device  number  9.  The  DO  loop 
increment  is  written  out  to  this  file.  No  format  is  necessary, 
although  a  format  could  have  been  used.  In  line  50  the  file  is 
closed.  Line  60  opens  the  file  as  an  input  file.  Line  80  reads  the 
data  and  line  90  writes  them  on  the  printer.  Line  110  closes  the 
file. 

If  it  is  desired  to  reread  a  disk  data  file,  it  is  possible  to 
reset  the  file  back  to  the  beginning  with  a  rewind  statement.  To 
rewind  the  file  above,  use  the  statement: 

115  REWIND  9 

CREATING  DATA  FILES  WITH  DIBCADBU 

The  DIBCADBU  utility  can  be  used  to  place  data  decks  into  a 
user's  userid  library.  See  the  section  on  DIBCADBU  to  prepare  the 
necessary  header  card.  Bring  the  data  deck  to  User  Services  who  will 
run  the  utility  and  place  the  deck  in  the  library.  The  DIBCADBU 

utility  is  a  batch  processor  which  can  only  run  when  CALL/VS  is  not 

■ 

active.  Currently,  we  run  DIBCADBU  in  the  morning  before  CALL/VS 
comes  up  at  9  a.m. 


FILE  PROTECTION 
* 

It  is  possible  to  protect  a  file  in  the  userid  library  from 
accidently  being  destroyed.  The  command  is: 


LOCk  filename 


' 
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This  command  locks  the  program  or  data  file  in  the  userid  librarj. 
The  file  cannot  be  deleted,  nor  another  file  with  the  same  named  save: 
or  stored  in  the  library,  without  first  removing  the  LOCK  protection. 
If  a  data  file  is  locked,  it  cannot  be  opened  for  output  without  UN¬ 
LOCKING.  For  example: 
lock  trial 

To  remove  the  protection,  issue  an  UNLOCK  command: 

UNLock  filename 
To  UNLOCK  TRIAL  type: 
uni  trial 

The  user  may  also  wish  to  SECURE  files.  Issuing  the  SECURE 
command  prevents  any  other  user  from  copying  the  file  using  the 
DIBCADBU  utility.  The  general  form  is: 

SECure  filename 


To  SECURE  TRIAL  type: 
sec  trial 

To  remove  security  issue  a  RELEASE 


y  *3 


command  of  the  form: 


RELease  filename 
To  RELEASE  TRIAL,  type: 


rel  trial 

If  a  file  has  been  created  using  DIBCADBU,  the  SECURE  attribute 
is  set  automatically. 


The  commands  LOCK,  UNLOCK,  SECURE,  and  RELEASE  apply  to  the 
userid  library  only.  To  protect  files  in  the  other  libraries  see  the 
next  section. 


, 
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PLACING  FILES  IN  SHARED  LIBRARIES 

A  user  may  place  a  program  or  data  file  into  the  single  star  or 
double  star  libraries.  Remember  that  the  single  star  library  is 
accessible  by  users  having  the  same  first  four  characters  of  the 
userid  in  common.  The  double  star  library  is  accessible  to  =11  user 5 
To  place  a  program  in  the  single  star  library  type: 

'  •  ’  ■  4  . 

POOl  *filename 

To  place  it  in  the  double  star  library  type: 

POOl  **filename 

The  filename  must  currently  reside  in  the  user's  userid  library 
to  be  pooled.  The  filename  is  1-8  characters  not  counting  -he  aster¬ 
isks. 

To  POOL  TRIAL  in  the  double  star  library,  type: 

poo  **trial 

To  remove  a  pooled  file,  PULL  it.  The  command  form  is: 

PULI  *filename 
or 

PULI  **filename 

To  PULL  TRIAL  from  the  double  star  library,  type: 

pul  **trial 

Only  the  userid  that  POOLed  the  file  can  PULL  it.  This  allows 
perfect  protection  provided  the  userid  and  password  are  kepi  a  seen:. 

A  user  can  flag  a  program  to  be  "run  only"  —  that  is,  not 
capable  of  being  listed,  saved,  or  stored  —  by  PROTECTinc  it.  The 
command  is: 

PROtect  filename 

l 

\ 

\ 


1 
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9 

UPDATE  OCTOBER  1,  1975 
POOLING  IN  THE  DOUBLE  STAR  LIBRARY 

If  a  user  wishes  to  POOL  a  file  into  the  double  star  library, 
permission  must  be  first  obtained  from  User  Services.  To  POOL, 
fill  out  the  appropriate  form  with  User  Services  Data  Controller 

located  in  Administration  124.  This  restriction  is  necessary  to 

-  - 

control  the  size  of  the  library  and  to  assist  in  making  available 
valuable  user-supplied  programs  to  the  user  community. 

This  restriction  does  not  apply  to  the  single  star  library. 


i  *  * 


• 1  ..  ..  r  t 


\ 

\ 


— 
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NOTE:  No  asterisks  preceed  the  name.  To  PROTECT  TRIAL,  type: 

pro  trial 

To  remove  the  PROTECTion,  issue  an  ALLOW  command  of  the  form: 
ALLow  filename 

Again  no  asterisks  are  in  the  filename.  This  ALLOWS  other  users 
to  list,  save,  or  store  the  file.  They  still  cannot  alter  it.  Tc 
ALLOW  TRIAL,  type: 

all  trial 

OTHER  COMMANDS 

CATALOG 

It  is  possible  to  take  a  closer  look  at  the  userid  library  then 
the  one  taken  earlier  in  this  manual.  Give  the  command: 

cat  all 


10;*',  4 
C||F  fH\M 

04/ ?  n/ 75 

F  TVOr 

T'Jiin^nA  v 

LAMRf'lARR 

°RQ0R AM  A  1 7 F 

FII.F  UNITS 

HAY'S  ST 

CWR 1 

OPOC 

fortran 

If!  2 

0 

r  5  o 

nnqn, 

FORTRAN 

IP? 

3 

TR 1  AL 

PROG 

FORTRAN 

85 

0 

tri  Ai.n 

0P..I 

FORTRAN 

3 

0 

n>\T/vso 

RR00 

OAJA 

3A 

0 

hat]  n 

HAT  A 

FORTRAN 

1 

0 

/CMRl 

00.1 

FORTRAN 

h 

0 

RW1,  CWR50 ,  and  TRIAL  are  PROGrams  written  in  FORTRAN.  The  prr- 
gram  size  tells  us  the  number  of  characters  each  takes.  Remember  tie 
maximum  size  is  28,848  characters.  TRIALO  is  stored  in  OBJect  fort 


\ 

\ 
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from  source  written  in  FORTRAN.  It  takes  three  file  units  to  store  it. 
It  is  more  efficient  in  disk  storage  to  save  source  code  than  to  store 
object  programs.  It  is  more  efficient  to  execute  from  object  than 
from  source  code.  DATA 50  is  program-data  created  by  entering  data  ir. 
the  data  mode  from  the  terminal.  DAT 10  is  a  data  file  used  by  a  FOR¬ 
TRAN  program.  It  was  created  with  a  FILE  statement.  It  has  one  file 
unit.  File  units  will  be  added  as  the  file  grows  up  to  a  maximum  of 
4.  When  four  file  units  are  reached,  the  file  size  must  be  increased 
using  the  FILE  command.  /CWRl  is  an  object  program  created  by  issu¬ 
ing  a  STORE  command  when  CWRl  was  in  the  work  area.  If  a  name  is  not 
used  with  the  STORE  command,  it  will  take  the  name  of  the  program 
currently  in  the  work  area  and  add  a  /  to  the  front  of  the  name. 

The  /  counts  as  one  of  the  eight  characters  permitted  in  a  file  name. 

K-lnO:  .  *  t.'  ic  . uenrjss  ^  -  ;  , 

TRIALO  was  created  with  the  statement: 

store  trialo 


x,r  ^ 


when  TRIAL  was  in  the  work  area. 

/CWRl  was  created  with  the  statement: 
store 

when  CWRl  was  in  the  work  area. 

t  .  r— •.  ..  ...  • 

Information  can  be  obtained  concerning  the  contents  of  the  starred 
libraries.  Type  cat  followed  by  a  blank  and  then  one,  two,  or  three 
asterisks . 


, 
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WIDTH 

This  command  sets  the  width  of  a  line  to  be  used  for  printin 
information  at  the  terminal.  It  is  used  only  if  the  line  width  d 


for  listings  or  output  is  other  than  72  print  positions,  which  is 
CALL/VS  default.  The  effective  line  widths  for  terminals  are: 


r?  f 


2741  130  positions 

Teletype  72  positions 

Execuport  80  positions 

■ 

To  change  the  line  width  give  the  command: 


width  130 
ready 


•• 

. 


If  a  line  width  greater  than  the  effective  maximum  is  given, 
excess  characters  will  be  over-printed  in  the  last  valid  column. 


OFF 


XVSX\  ^  | 


To  logoff  the  system  type: 


<  l  ..{x'xxv*:  >  r‘>-  - 


off 

OFF  AT  9:18 
PROC  TIME  0  SEC. 

TERM  TIME  3  MIN. 

.  v  ?  ,  C  I  -  ■/  -  'i  v'.  1  \  jr  x. 

Then  turn  off  the  terminal  and  hang  up  the  phone. 


i 


THE  DIBCADBU  UTILITY 


It  is  possible  to  place  programs  or  data  files  into  a  userid 
library  using  the  DIBCADBU  utility.  The  utility  is  run  by  User 
Services  once  a  day.  The  utility  cannot  be  used  when  CALL/VS  is 
running. 


\ 

\ 

\ 


i 


— 
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^NSERT/REPLACE  Function  Statement 

The  INSERT/ REPLACE  function  statement  specifies  the  operations  to  be 
performed.  The  specific  options  available  with  the  INSERT/REPLACE 
function  are  described  below. 


r-.n  r  >  o 


o% 


Hote:  C>  -  select  one  from  enclosed  list 

II  -  indicates  optional  parameter 

To  place  a  FORTRAN  program  called  TRIAL  existing  on  cards  in 

userid  library  SUS101,  password  =  UI,  the  card  would  look  like: 

./  INSERT  USER=SUS101,CLUSTER=1,LANG=FORTRAN, 

. /  PASSWORD=UI ,  NAME= TRIAL 

Blanks  appear  only  after  the  ./  and  after  the  word  INSERT, 
other  blanks  can  appear  except  after  the  last  comma  on  the  first 
Columns  1  to  71  are  available.  Column  72  must  contain  a  blank. 


1“2|  Mnemonic  | 

t - +- 


./ 


INSERT 

or 

REPLACE 


Parameters 

USER=  (aaannun |  SYSLIB l  ♦♦LIB)  , 
£USR2=aaanpp, 1 CLUSTER=k, 


,  rt.f 


IFROMOSER=  C  bbbrqq | SYSLIB | ♦♦LIB} , 1 
lFROMCLUS=j,] 

IINP0T= (CARDJ OSDS | DISK | TAPE} , 1 
[LANG= (BASIC | FORTRAN | PL/I | DATA} , 1 

~  'ii i • "  « '  J  .-3  .i, «:  -Hh 

PASS WORD=xxxxxxxx , (USERPASS=yyyyyyyy, J 
(FILE= (PROG | DATA | BOTH} , ] 

(NAME= (filename | xxxxxxx. | (ALL)},) 


(RENAME= { newname | yyyyyyy . } , 1 


mm; t 


-£  :&■ 


v  0  tJ-i- 


(MARG=(nnn,nn)  ,  ] 

£LINEGEN= (SEQ,  xxxxx} , ] (LINEINC=xxxxx, ] 

COPTIONS=((SEQ,] (LIST,] (UNLOCK,] (LOCK] 
(LONG,] (PROTECT,] £♦,)(♦♦,) 
(OBJECT, ) (FORMDATA, ] (VAL] ) , ] 


fiO 


(SPACE=sss ] 


1 


-dt 

A  A  •• 


i 
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To  place  a  program  data  deck  in  your  userid  library,  obtain  a 
source  deck,  put  on  a  header  card  similar  to  the  one  above  and  bring 
it  to  User  Services. 

If  your  program  is  on  any  other  medium  than  cards  or  you  wish  ~o 
do  anything  else,  please  consult  User  Services. 

The  DIBCADBU  utility  will  provide  line  numbers  for  your  pro- 

. 

grams  automatically. 

CALL/VS  LANGUAGES 

. 

CALL/VS  FORTRAN 

If  a  FORTRAN  statement  cannot  be  completed  on  one  line,  it  can  be 
continued  on  one  or  more  continuation  lines.  A  statement  is  identified 
to  be  continued  if  the  last  nonblank  character  in  the  line  is  either 
a  %  or  a  -  (hyphen) .  The  next  line  is  the  continuation  line.  For 
example : 

100  X=  (Y+Z) / (A+C) /% 

110  (Q+50. ) 

Line  110  is  a  continuation  of  line  100. 

The  program  may  contain  COMMENT  statements.  To  enter  a  COMMENT 
statement,  type  the  line  number,  a  blank,  then  "  followed  by  the 
comment.  For  example: 

150  "THIS  IS  A  COMMENT  STATEMENT 
It  is  not  necessary  to  close  the  statement  with  " . 

It  is  possible  to  CHAIN  two  programs  together.  The  execution  of 
the  CHAIN  statement  causes  another  program  to  be  loaded  into  the  work 
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area  and  executed.  The  CHAIN  statement  also  allows  a  16  byte  variable 
to  be  passed  to  the  chained  program.  A  CALL  PARM  statement  is  needed 
in  the  chained  program  to  receive  the  variable.  The  form  cf  the  CHAIN 
statement  is: 


CALL  CHAIN 


"progname"  is  a  variable  or  literal  constant  identifying  an  eleven- 
character  program  name  (the  first  one,  two,  or  three  characters  may 
be  asterisks  if  the  program  is  accessed  via  a  shared  library)  . 
"Parameter”  is  optional;  if  supplied,  it  is  a  variable  or  literal 
constant  to  be  passed  as  a  16-byte  parameter  to  the  chained  program. 

If  "parameter"  is  omitted,  the  literal  constant  ' NULLNULLNU1LNULL *  is 
passed  to  the  chained  program. 

The  CALL  PARM  statement  is  of  the  form: 

CALL  PARM (y) 

"y"  is  a  variable  identifying  an  area  at  least  16  bytes  in  length, 
which  upon  return  from  PARM,  will  contain  16  bytes  of  data  passed  tc 
j  this  program  from  the  chaining  program. 

The  following  example  illustrates  the  use  of  chaining.  The  first 
program  is  CHAIN1 

10  CALL  OPEN  (8, ' CHAINTRY ' , 'OUTPUT' ) 


20  DO  5  I  =  1,10 
30  WRITE (8)  1 
40  5  CONTINUE 
50  CALL  CLOSE  (8) 

55  CALL  CHAIN  (' CHAIN2 ',' CHAINTRY ' ) 
60  END 


\ 


\ 
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It  opens  a  file  named  1 2 3 4 5 6 7 8 9 10 CHAINTRY ' ,  writes  into  it,  closes  it, 
and  in  line  55  calls  a  program  named  'CHAIN2'  and  passes  to  it  the 
name  of  the  data  file,  'CHAINTRY'. 

CHAIN2  appears  below: 


5  CALL  PARM ( ' CHAINTRY ' ) 

10  CALL  OPEN  (9, 'CHAINTRY' 
20  DO  5  I  =  1,10 
30  READ  (9)  J 
40  WRITE (6,*)  J 
50  5  CONTINUE 
60  CALL  CLOSE (9)  w 
70  END 

Line  5  receives  the  file  name 


, ' INPUT ' ) 

'  r.  .  ’  ; 


from  CHAINl  using  the  CALL  PARM 


statement.  In  this  example  the  parameters  are  literal  constants;  the/ 


could  have  been  variables. 

The  command: 
run  chainl 

CHAINl  9:35  05/02/75  FRIDAY 

1 

2 

3 

4 

5 

6 

7 

8 

9 

10 

STOP 

TIME  0  SECS. 


*  k  " 


caused  CHAINl  to  be  executed  which  in  turn  caused  CHAIN2  to  be  executed. 
After  execution  CHAIN2  resides  in  the  work  area. 
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The  following  features  are  not  available  on  CALL/VS  FORTRAN: 
1.  The  BACKSPACE  statement 


2. 

The  DOUBLE  PRECISION  statement  (REAL* 8  is 
supported) 

3. 

The  ENTRY  statement 

4. 

The  IMPLICIT  statement 

5 

v  • 

The  NAMELIST  statement  and  NAMELIST  input/output 

6. 

Labeled  COMMON  and  BLOCK  DATA  subprogram 

' 

7  • 

.4-  'i  _ _ 

Logical  data,  constants,  variables,  operators, 
expressions,  functions,  or  declarations. 

(Logical  IF  statements  are  supported.) 

8. 

Z  (hexidecimal)  and  L  (logical)  codes  in  FORMAT 
statements . 

9. 

Direct  access  input/output  statements: 

' 

-■ 

..  3*;  ; 

a.  DEFINE  FILE 

b.  READ  (u'r ,f ,ERR=s)  list 

c.  WRITE  (u'r,f)  list 

d.  FIND  (u'r) 

10. 

FORTRAN  II  input/output  statements 

I1;-;  ■  »  ./  •  \  • 

11. 

The  following  FORTRAN  —  supplied  subprograms: 

■ 

a .  DUMP 

b.  PDUMP 

c.  SLITE 

d.  SLITE7 

12. 

The  debug  facility 

13. 

OS  job  control  facilities 

Refer  to  CALL/OS  FORTRAN  Language  Reference  Manual  GH2 0-0710  fc 
further  information  about  CALL/VS  FORTRAN. 


\ 

\ 


i 


— 
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CALL/VS  PL/I 

The  following  is  a  list  of  some  of  the  facilities  excluded  from 


the  CALL/VS  PL/I  Language: 

1.  Record  I/O  is  not  supported. 


2.  Stream  I/O  is  supported  with  a  restricted  set 
of  attributes. 

3.  Dynamic  storage  allocation  is  restricted. 

4.  The  BIT,  PICTURE,  and  GENERIC  attributes  are 
not  supported. 

5.  Structures  are  not  supported. 

6.  Condition  prefixes  are  not  supported. 

11.  The  BINARY  functions  are  not  supported. 

12.  The  ON-conditions  are  restricted. 

13.  Extended  precision  is  not  supported. 

14.  Initialization  of  data  is  not  supported. 

15.  LABEL  lists  are  not  supported. 

.  •  ■  : :  •  :  lx",.  t  •?  r  •*>  .  r  ..  '?  i  ~  *■ 

To  write  a  program  type: 
cle 


to  clear  the  work  area  and  then: 


enter  pl/i 

to  enter  the  PL/I  language  mode.  Then  enter  the  statements  by  typing 
the  line  number  and  the  statement  (only  one  statement  per  line) . 


10  a:  procedure; 
20  x  =  0. ; 

30  do  i  =  1  to  5; 
40  get  list  (y) ; 
50  x  =  x  +  y; 

60  end; 

70  put  list  (x) 

80  end  a; 
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run 


10:02  05/02/75  FRIDAY 

V8 
V78 
V.  06 
V5.8 
V67 

1. 58859E+02 
TIME  0  SECS. 

3'xi;  -iitSrS**'  f.'ie: 

The  PL/I  expression  to  open  a  file  is: 


*_■?:  '*5,  y'*'r 


OPEN  FILE (filename) TITLE { 'disk-file-name ') INPUT  or  OUTPUT; 


t  ft  -SS  •’ 


The  filename  is  the  name  of  the  file  to  be  opened.  It  is  the 
filename  used  by  the  program.  The  'disk-file-name '  is  the  name  given 
to  the  disk  file  created  in  the  FILE  statement.  If  the  program  file 
name  and  the  disk  file  name  are  identical,  the  OPEN  statement  can 


Si  3  o  3 


simply  be: 


«  o J  r  1 4ri &j:  /  r.  i' 
•to  a:;:;.  .3 


OPEN  FILE (filename) INPUT  or  OUTPUT; 

Use  INPUT  or  OUTPUT  to  specify  the  desired  option.  If  INPUT 


or  OUTPUT  is  omitted,  INPUT  is  assumed.  The  form  for  the  CLCSE  state- 

y.yy  .  if-.sjr.-f  hjSfe  r  r a.j 

ment  is: 

CLOSE  FILE (filename) ; 

r r. !  c  v  -  vc  ...  ii-nn&c  i::.  n  : -v  v .-r •••■.?«  -■  «,  ...=  .. 

A  file  should  be  closed  when  it  is  no  longer  needed.  For  example: 
CLOSE  FILE (MASTER) ; 

The  PL/I  CHAIN  statement  has  the  form: 

CALL  $CHAIN  (name  [],  data*]) 

where  "name"  is  the  name  of  the  program  to  be  invoked  and  "data"  is  a 
character  argument  to  be  passed  to  the  chained  program. 


r 


' 
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To  reset  disk  input  and  output  files  use  the  $RESET  subroutine. 
The  form  is: 


CALL  $  RESET  (filename  [^filename , .  7}  ) 

For  input  disk  files,  the  file  is  reset  to  the  start  cf  the  fil 
For  output  files,  the  current  half-track  of  data  in  the  output  buffe 
is  written  to  the  disk,  and  the  file  is  reset  to  the  start  zf  the 


file. 


ft* 


For  more  information,  about  CALL/VS  PL/I  see  "CALL/360 
PL/I  Language  Reference  Manual",  GH20-0700. 


•  •  •  '  .w  ti . 

OS 


CALL/VS  BASIC 


The  CALL/VS  BASIC  language  is  based  upon  the  BASIC  language 
originally  developed  at  Dartmouth  College.  CALL/VS  BASIC  extensions 
include: 

1.  Specification  of  short-or  long-form  arithmetic 

2.  Three  intrinsic  constants:  pi,  the  natural 
number  e,  and  the  square  root  of  2 

3.  Precise  control  of  printed  output  via  format 
pictures 

j  *.<  «■  v 

>■''  r  >■';  •  V 

4.  Program  branching  using  computer  GOTO  state¬ 
ments 

5.  Data  file  storage 

All  arithmetic  computations  in  BASIC  are  performed  on  floating¬ 
point  numbers.  A  floating  point  number  is  a  machine  approximation  c 
the  value  of  a  real  number. 


\ 
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A  CALL/VS  BASIC  program  may  be  compiled  and  executed  using  either 
short-form  arithmetic  or  long-form  arithmetic;  the  mode  is  specified 
via  the  ENTER  command.  ENTER  BASIC  specifies  short-form  floating 
point  computations,  while  ENTER  BASICL  specifies  all  computations  are 
to  be  performed  in  long-form  floating  point  arithmetic.  The  long- 
form  computations  will  be  more  accurate,  but  they  will  also  require 
more  machine  time  to  compute. 

The  following  is  an  example  of  a  program  written  in  BASIC: 


10  x  s  0. 

20  for  i  =  1  to  5 
30  input  y 
40  x  =  x  +  y 
50  next  i 
60  print  'x  =  '  x 
70  end 


<-om 


run 


9:50  05/02/75  FRIDAY 


?  xc  1 


V689 
V5.0 
V56 
V123 
V.  009 

X  =  873.009 

TIME  0  SECS. 


. 

-  -  L- 


i  ,  .. 

•  • 


!  it. 


;is. 


To  use  disk  files  it  is  necessary  to  use  CALL  OPEN  and  CALL  CLOSE 
statements. 

The  general  form  of  the  OPEN  statement  is: 

OPEN  u,f, INPUT  or  OUTPUT 

where  u  is  a  file  number  (expression)  and  f  is  a  file  name  (alpha¬ 
betic  variable  or  literal  constant) . 


. 
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This  statement  causes  the  data  file  or  program-data  file  nan ef 
by  f  to  be  assigned  to  the  file  number  specified  by  u.  INPUT  or  '77 
PUT  must  be  specified.  For  example: 

100  OPEN  1, ’MASTER’ , INPUT 

When  processing  of  the  file  is  complete,  the  file  should  be 
closed.  The  general  form  is: 

CLOSE  u  or  f 

where  u  is  a  file  number  (expression)  and  f  is  a  file  name  (liter=_ 
constant) . 

This  statement  causes  the  data  file  or  program-data  file  spe:_- 

fied  by  the  file  number  u  OR  file  name  f  to  be  closed.  For  example 

120  CLOSE  1  or 
120  CLOSE  'MASTER' 

More  than  one  file  can  be  closed  by  a  CLOSE  statement.  Separate 
names  of  the  files  with  commas. 

To  reset  a  disk  file  back  to  the  start  use  a  reset  command  of 
the  form 

RESET  (u  or  f) 

where  "u"  is  a  file  number  and  "f"  is  a  filename. 

For  more  information  about  CALL/VS  BASIC,  consult  "CALL-OS  BAil 
Language  Reference  Manual"  GH20-0699. 


\ 
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EZSTAT 


..  .  . 

EZSTAT  is  a  utility  statistical  package  designed  to  be  run 


interactively  on  small  samples.  The  programs  have  been  develope 
using  CALL/VS  BASIC.  To  use  EZSTAT  the  individual  should  be  awa 
of  the  operational  procedures  for  the  terminal  and  time-sharing 


support  system. 

EZSTAT  is  composed  of  several  programs,  each  designed  for  t 
statistical  analysis  of  small  samples.  Services  are  provided  fc 


Program  Name 

DFB 

DFE 

DFT 

XTAB 

HIST 

DESCR 

TTEST 

CANON 

ONEWAY 

KWALLIS 

KRANK 

WMP 

COCHRAN 

FRIEDMAN 

MANN 

KENDALC 

BISERIAL 

POINTBI 

MOVAVE 

SEAS 

CYCLICAL 

TRIPLE 

CHI 

BICOR 

LREG 

STEPWISE 

MLR 


V  - 
\ 

Program  Function 

File  Building 

File  Editing 

Variable  Transformation 

Cross  Tabulations 

Histograms 

Data  Description 

T-Test 

Canonical  Correlation 
One  Way  Analysis  of  Variance 
Kruskal-Wallis  AOV 
Kendall  Rank  Correlation 
Wilcoxon's  Match  —  Paris 
Signed  —  Ranks  Test 
Cockran  Q  Test 
Friedman  Two  Way  Analysis  of 
Variance 

Mann  Whitney  U  Test 
Kendall  Coefficient  of  Con¬ 
cordance 

Biserial  Correlation 

Point  Biserial  Correlation 

Moving  Average 

Seasonal  Analysis 

Cyclical  Analysis 

Triple  Exponential  Smoothing 

Chi  Square 

Bivariate  Correlation 
Least  Squares  Regression 
Stepwise  Regression 
Multiple  Linear  Regression 


\ 
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Program  Name 


Program  Function 


POLYREG 

DI SCRAN 

FACTOR 

CORR 

SIGN 

MERGE 


Polynomial  Regression 
Discriminant  Analysis 
Factor  Analysis 
Correlation 
Sign  test 

File  Merge  Faculty 


All  the  above  programs  are  in  the  triple  star  library  and  should 
be  preceded  with  three  asterisks.  For  example;  to  run  DFB ,  type: 
run  ***dfb 

The  user  should  be  knowledgeable  in  the  area  of  statistical 
analysis  attempted.  Proper  application  of  analytical  techniques  and 
interpretation  of  the  results  is  not  an  intrinsic  matter. 

Each  program  in  EZSTAT  is  designed  to  accept  data  from  a  pre¬ 
built  file.  Descisions  regarding  options  and  analysis  are  offered 
at  execution  time.  Data  is  presented  to  the  program  in  a  standard 
format.  Up  to  two  hundred  observations  of  up  to  twenty  variables 
can  be  analized.  These  data  must  be  entered  into  a  file  using  the 
Data  File  Build  or  equivalent  routine. 

The  conceptual  approach  of  EZSTAT  is  the  following: 


1.  Data  is  collected  and  decision  on  necessary 
analysis  is  made. 

2.  User  allocates  space  for  file  of  data.  (Under 
CALL/VS  an  allocation  of  five  units  is  necess¬ 
ary  . ) 

3.  Data  file  is  build  using  DFB. 

4.  Editing  of  file  is  performed  if  necessary. 

5.  Transformations  are  performed  if  necessary. 

6.  Statistical  analysis  is  run. 

y  4 

7.  Results  studied  —  if  further  work  is 
necessary,  a  return  to  step  four  is  made. 
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While  the  approach  of  EZSTAT  is  attractive  to  the  non-cor.outer 
oriented  individual,  it  can  provide  difficulties  if  applied  incor¬ 
rectly. 

The  casual  user  is  urged  to  study  his  problems  carefully  before 
embarking  on  solutions.  This  package  is  designed  for  the  statistical 
analysis  of  small  samples.  Large  problems  should  be  handled  using 
more  sophisticated,  batch  oriented  packages. 


rv?- 


A  SAMPLE  EZSTAT  SESSION 


j 


The  first  step  is  to  create  a  file  to  be  used  with  the  DF3  data 
file  builder.  To  create  a  file  called  "EZTRY" : 
file  eztry,5 

NOTE:  The  file  must  be  given  5  file  units  regardless  of  the  size 

of  the  input  file.  Then  build  the  data  file  by  executing  *  *  *D7B . 


run  ***dfb 


OFT 


O-V  li 


*1:3.3  05/0^/75  MONPav 


t : 


: 


i 


h MA  FI  LIZ  RUII.PER 
F*!TFR  DMA  AM  ORr.rovATlOf  AT  A  J | nr 
U°  TO  20  VAR  I  ARLFO  0AM  I'SFO 
UP  TO  700  OP.SFRVATIONS  APF  At  l_0!/rp 
NOV/  MANY  VAR  I  AP.Lrn  PO  Vf)U  HAvc? 

V3 

HO1/  MAMV  Op0rRwAT  1 0M3  PO  YOU  HAVP? 

V5 

^HAT  IS  T'lR  HAME  OF  Tilt  FILE  YOU  HAVF  ALLOCATE, 
Vez try  ' 1  -  • 

INPUT  ROW  i 

V3,5,n 


INPUT  now 

vo. 8, h,  n 


INPUT  ROW 
V  7  "  ,  3  , 5 


I  Nf'lJT  ROW 

vr,,s,3 


*r‘ 


INPUT  ROW  5 

V7,3,5 

DO  YOU  WANT  TO  ALTER  THE  DATA  FILE’ 

Vno 

TIME  1  SECS. 

Once  the  input  file  is  created  any  of  the  other  EZSTAT  programs 
can  be  run  against  the  file. 

On  the  following  page  are  two  examples. 


run 


aescr 


~rr>CR  o ;  3C  ^5/05/75  momray 

R'»TA  OESCE  I  pT I  0M  FACILITY 


; WAT  FI Lc  no 
u»ztry 

7  A  R 1 ARLE 

1 

2 

3 

YOU  WANT 

MEAN 

20. 7f on 
4.C000 
4.8000 

To  PROCESS? 

MAXIMUM  MINIMUM 

78.0000  3.0000 

2.0000  3.00C3 

6.0000  2.0000 

TIME  1  SECS. 

run***corr  1 

COP.R 

0  :  37  05/05/  75  momo.ay 

• 

t.  DEAR  CORRELATION  COEFFICIENT  MEASUREMENT 
•/HAT  ^ILE  00  YOU  ’/ISM  TO  nsr? 

'rnz  t  ry 

W'WC!I  TWO  VAP |  ARLES  ARE  T"  RE  CORRELATED? 
71,  2 

CORE.  COEF.  FOR  1  V'n  0  IS  -.45188 
CO^ari AUCE  IS  -30.07 

rO  YOU  WANT  AMOTHrr*  COrFP  |  E  |  P‘«to 
'y^s 

W,JIC:i  TWO  VARIABLES  ARE  TO  Rp  0ORncL ATrn? 
72,3 

0npR .  core.  P°p  ?  v:n  5  IS  -.7F30G 

CO  7  A?  I  A*/ CE  IS  -nr 

r  "*  YOU  W-V.’T  ANOTHER  CRERF I p I rNT? 

"no 


T  r*E  1  SECS, 

off 

OF F  AT  0:3R 

'•••or  t|m<-  t  r-(  f  r  > 

■*•  r  n » •  T  |  ' | r  r  **  |  •< 


vn  vn 


PAUSE  VARIANCE  ST.  REV.  3T.ERR.M.E 
.0000  1020. 7870  32.0*03  1  •# .  3512 

.0000  4.3000  2.C73S  0.0274 

4.0000  2.7000  1.6452  0.7342 


I 

oo 

i 


a  •  * 


f* 
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For  more  information  about  EZSTAT ,  consult  the  EZSTAT  User's 
Guide. 

i 


CALL/VS  MANUALS 


More  information  about  CALL/VS  can  be  obtained  from  the  follcv- 


ing  manuals : 

GH20-0787 

GH20-0699 

GH20-0700 

GH20-0710 

GH20-0786 


CALL-OS  TERMINAL  OPERATIONS  MANUAL 

CALL-OS  BASIC  LANGUAGE  REFERENCE  MANUAL 

CALL/3 6 O-OS  PL/I  LANGUAGE  REFERENCE  MANUAL 

CALL-OS  FORTRAN  LANGUAGE  REFERENCE  MANAUL 

CALL-OS  EXECUTIVE  AND  UTILITIES  PROGRAM 
DESCRIPTION  MANUAL 


c;  ... 

/  •  ,  c; ,  ::  v  - 

'■  CL  ,  '.3nL-v 


. 

b  1 1 ,  >-  ■  .  uaciAfis: .. 

* 

■ 
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INDEX 


ACCOUNT 

Establishing,  2 
Form,  4 

ADDING  STATEMENTS,  15 
ALLOW  COMMAND,  30 
BASIC,  2 

CALL/VS  BASIC,  41 
CHAINING,  43 
ENTER,  9 
OPEN-CLOSE,  42 
SAMPLE  SESSION,  42 

CALL  CLOSE 

..  "  lx‘.  V  '  **  •’  -  '  ;"T  r'-"'  "•  '  '  r~ 

BASIC,  42 
FORTRAN,  25 
PL/I,  42 

CALL  OPEN 

BASIC,  42 
FORTRAN,  24-25 
PL/I,  40 

CATALOG 

CATALOG,  10,30 
SHARED  LIBRARIES,  31 

CHAINING 

BASIC,  43 
FORTRAN,  35 
PL/I,  40 

CHARACTER  DELETE 

2741,  8 
TTY,  8 

CLEAR  COMMAND,  7 
CLOSE,  CALL 

see  CALL  CLOSE 


COMPILE 


RUN  6,11 
DATA 

DIBCADBU  CREATED,  27,34 
ENTER,  9,30 
FILE  STATEMENT,  26 
FILES,  23,30 
MODE,  2 

PROGRAM- DATA ,  3  0 
PROGRAM  CREATED,  26 
TERMINAL  INPUT,  24 

DATA  FILES 

DIBCADBU,  34 
POOLING,  29 
SHOWN  BY  CATALOG,  30 
STORAGE  UNITS,  26 
TYPES,  23 

DELETE  COMMAND,  14-15 

DIBCADBU  UTILITY,  4,23,27,28,33 

EDIT 

Commands 
ADD,  17 
DELETE,  14 
EXTRACT,  20 
FIND,  19 
INSERT,  20 
LIST,  13 
MERGE,  22 
MOVE,  20 
NAME,  21 
RENUMBER,  18 
REPLACE,  18 
Editing  Programs,  13 
ENTER  Command 
BASIC,  9 
DATA,  9 
FORTRAN ,  9 
PL/I,  9 


r 
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EXECUTE 

RUN,  6,11 

EXTRACT  COMMAND,  20 
EZSTAT,  44 
FILE  NAME,  17,26,29 
FILE  PROTECTION 

USERID  LIBRARY,  27 
SHARED  LIBRARIES,  29 

FILE  COMMAND,  26,31 


MANUALS,  49 
MOVE  COMMAND,  20 
NAME  COMMAND,  21 
OFF  COMMAND,  33 
OPEN,  CALL 

see  CALL  OPEN 
PASSWORD 

DEFAULT,  2 
CHANGING,  2 

PHONE  NUMBERS,  5 
PL/I,  2 


SHARED  LIBRARIES,  29 

FIND  COMMAND,  19 
FORTRAN 


CHAINING,  40 
ENTER,  9 
EXCEPTIONS,  39 
OPEN-CLOSE,  39 
SAMPLE  SESSION,  39 


CALL/VS  FORTRAN,  35 
CHAINING,  35-36 
COMMENT  STATEMENT,  35 
CONTINUATION,  35 
ENTER  COMMAND ,  9 
EXCEPTIONS,  38 


FREE  FORM  ENTRY,  11 
INSERT  COMMAND,  20 
LIBRARIES 


USERID,  2,4,22,30,34 
SINGLE  STAR,  1,22,29,31 

DOUBLE  STAR,  1,22,29,31 

TRIPLE  STAR,  1,22,29,31 

LINE  DELETE 


POOL  COMMAND,  29 
POOLING,  1,2,29 
PROGRAM  SIZE,  22 
PROTECT  COMMAND,  29 
PULL  COMMAND,  29 
PURGE  COMMAND,  13 
READ 

PROMPTER,  6 
EDITED,  7 

RELEASE  COMMAND,  28 
REMOVING  PROGRAMS 


-Al 


iiO 


PURGE,  13 

FROM  SHARED  LIBRARIES,  29 


2741,  9 
TTY,  9 


RENUMBER  COMMAND,  21 
RUN  COMMAND 


LINE  NUMBERS,  10,11 
LIST  COMMAND,  13,14 
LOCK  COMMAND,  27 
LOGOFF 

See  OFF,  33 
LOGON,  3,5 


USERID  LIBRARY,  6 
SINGLE  STAR  LIBRARY,  6 
DOUBLE  STAR  LIBRARY,  6 
TRIPLE  STAR  LIBRARY,  6 

SAVE  COMMAND 


2741,  5 
TTY,  5 


PROGRAMS,  11,12 

CHANGES,  16 

SHARED  LIBRARIES,  29 


\ 
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SECURE  COMMAND,  28 
SHARED  LIBRARIES 

POOLING,  29 
PULLING,  29 
PROTECTION,  29 
ALLOWING,  29 


STATISTICAL  PACKAGE 


EZSTAT,  45 

STATEMENT  CHANGES 

RETYPE,  18 
REPLACE,  18-19 


STATUS  COMMAND,  32 
STORAGE  UNITS,  26,31 
STORE  COMMAND,  12,31 
SUBPROGRAMS,  21-22 

>  •  V  ■ 

MERGE,  22-23 


%  *  l 


iv 
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TIME  COMMAND,  32 
UNITS,  STORAGE 

see  STORAGE  UNITS 
UNLOCK  COMMAND,  28 
USERID 


jimg:) 


,  i  v  i 


OBTAINING,  2 
LIBRARY,  1,22 


r  ;  c :mt& 
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WIDTH  COMMAND,  33 
WORK  AREA 


DEFINITION,  7 
CLEARING,  7 
SIZE,  22,2 
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PRI-I-ACK 


The  HTSARS  system  was  imp]emcntcd  out  of  a  need  to  have  a 
large  body  of  hydrologic  data  available  for  ease  of  access.  Many 
people  have  collected  information  for  a  project.  Often  the. find¬ 
ing  and  collection  of  the  necessary  data,  even  when  published, 
takes  an  inordinate  amount  of  time  when  compared  to. the  necessary 
analysis.  Since  much  of  the  hydrologic  data  is  in  published  form, 
the  real  need  was  for  an  efficient  storage  and  retrieval  system. 

A  search  of  available  systems  led  to  the  adoption  of  HISARS, 
developed  at  North  Carolina  State  University  by  Li. II.  Wiser.  In 
this  system  the  data  arc  stored  on  a  magnetic  disk  pack  and  the 
data  retrieved  by  the  Indexed  Sequential  Access  Method  (ISAM). 

The  data  elements  currently  supported  are  listed  in  Section  I.B.2. 

It  should  be  emphasized  that  almost  all  of -these  data  have  been 
obtained  from  governmental  agencies  such  as  the  National  Weather 
Service  and  the  Geological  Survev.  Because  of  the  very  large  amount 
of  data  in  this  system,  no  attempt  has  been  made  to  check  the  re¬ 
cords  which  are  assumed  good  until  proven  otherwise.  For  any  crit¬ 
ical  use,  the  user  is  advised  to  check  against  the  original  pub¬ 
lished  records.  It  would  still  be  advantageous  to  use  HISARS, 
even  in  that  case,  since  no  keypunching  and  additional  checking 
would  be  required.  In  case  any  errors  or  omissions  are  found, 
please  notify  the  author  so  changes  can  be  made. 

This  manual  is  organized  into  three  section;  the  ACCF.SS  fa¬ 
cilities,  the  PROCESS  facilities  and  the  COPY  facilities.  The 
ACCESS  facilities  merely  allow  a  user  to  obtain  listings  of  data 
in  a  standard  format.  These  are  described  in  detail  in  Section 

I .  D. 


The  PROCESS  facilities  (see  Part  II)  allow  routine  types  of 
analyses  on  the  data.  These  are  relatively  standard  types  of  pro¬ 
grams.  The  COPY  facility  allows  the  user  to  copy  data  from  the 
disk  pack  and  store  it  on  a  private  tape  or  data  set  where  it 
will  be  used  as  input  to  a  user  written  program  (sec  Part  III). 

This  user’s  guide  to  HISARS  has  been  patterned  after  the  Guide 
published  by  North  Carolina  State  University.  The  help  of  Ed 
Wiser  in  implementing  this  system  at  Idaho  is  gratefully  acknow¬ 
ledged.  Comments  about  HISARS  are  solicited  from  users,  whether 
they  be  about  these  Guides  or  the  files.  Any  comments  should  be 
directed  to  the  author. 

Since  this  is  a  new  system  and  additions  are  contemplated 
for  the  data  files  and  processing  program,  an  updating  list  will 
be  maintained  for  those  who  request  this  service.  Also  any  user 
who  has  data  that  may  be  useful  to  others  is  urged  to  consider 
adding  it  to  HISARS.  Please  contact  the  author  for  the  proper 
procedures . 


. 


I.  HISARS  USERS’  GUIDE:  THE  ACCESS  FACILITIES 


A.  INTRODUCTION 

The  access  facilities  of  HISARS  are  designed  to  provide 
copies  of  data  in  a  convenient  form.  These  are  merely  listings 
of  available  records  or  listings  of  data. 

The  following  shows  some  examples  of  use  of  the  access  fa¬ 
cilities  to  obtain  listings  of  indexes  and  data. 

Example  1.  To  obtain  a  list  of  all  stations  in  Idaho 
and  Lewis  counties  that  have  rainfall  data 
available . 

ACCESS 

ELEMENT  RAINFALL 

COUNTY  IDAHO  LEWIS 

LIST  INDEX 

Example  2.  To  obtain  a  printout  of  the  daily  rainfall 
records  for  Potlatch,  Idaho,  and  streamflow 
records  for  the  Palouse  River  at  Potlatch, 
Idaho . 

ACCESS 

ELEMENT  RAINFALL  STREAMFLOW 

STATION  107301  1534S000 

LIST  DAILY  10 


» 
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B.  COMMAND  LANGUAGE  SPECIFICATIONS  FOR  THE  ACCESS  FACILITIES 


The  following  commands  constitute  the  access  facility  of 


HISARS: 


ACCESS 

ELEMENT 

STATION 

LOCATION 

BASIN 

REGION 

COUNTY 

ELEVATION 

AREA 

ALTERNATE 

PERIOD 

LIST 

COPY 

AND 

OR 


opl 

opl 

opl 

opl 

opl 

opl 

opl 

opl 

opl 

opl 

opl 

opl 


The  command  word  is  punched  starting  in  Column  1 ,  followed  by  at 
least  one  blank  before  the  operand  opl  (if  any).  It  is  preferable 
for  checking  to  start  the  operand  in  Column  11,  but  this  is  not 
required . 

If  more  than  one  operand  is  required  for  a  given  command,  there 
are  three  optional  forms: 

a)  Several  operands  may  be  punched  on  a  single  card,  separat¬ 
ed  by  2  or  more  blanks.  Each  operand  must  be  complete,  i.e.  con¬ 
tinuation  of  an  operand  from  one  card  to  the  next  is  not  possible. 

b)  Operands  may  be  punched  on  consecutive  cards,  leaving  at 
least  one  blank  column  preceding  the  operand.  Thus,  any  cards 
with  Column  1  blank  are  assumed  to  contain  operands  that  are  assoc¬ 
iated  with  the  last  control  word. 

c)  The  command  itself  can  be  repeated,  with  a  different  oper¬ 
and  on  each  card.  In  this  case,  they  do  not  even  have  to  be  con¬ 
secutive  . 

A  group  of  command  cards  constitutes  a  single  access  request. 

A  group  is  always  begun  by  an  ACCESS  card,  followed  by  additional 
command  cards  in  any  order,  provided  only  that  at  least  one  ELE¬ 
MENT  card  is  included.  A  group  is  terminated  by  an  end  of  file 
card,  an  ACCESS  card  beginning  another  group  or  a  PROCESS  card  sig¬ 
nalling  processing  of  the  data  just  accessed. 

There  is  no  limit  to  the  number  of  command  cards  included  in 
a  single  group.  Thus,  a  large  number  of  stations,  counties,  etc. 
could  be  accessed  as  a  single  group.  Any  number  of  groups  may  be 
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stacked  for  a  single  run,  and  this  is 
However,  excessive  stacking  of  groups 
time  and  lead  to  possible  job  cutoffs 


encouraged  for  efficiency, 
will  increase  total  job 


l._  ACCESS 

The  ACCESS  command  signals  the  beginning  of  a  °gSC°”‘_ 

mand  cards  constituting  a  single  access  request '  else 

mand  must  always  be  the  first  card  in  ,a  •  *  ">  ^  Snored 

punched  in  the  card  following  the  word  ACCESS  will  be  ignored. 

This  is  a  convenient  location  for  comments. 


2.  ELEMENT 


The  ELEMENT  command  identifies  the 
which  access  is  requested.  The  operand 
one  of  the  standard  forms. _  The  followin 
in  the  current  implementation: 


element  or 
must  give 
g  elements 


elements  for 
the  element  in 
are  included 


a)  STREAMFLOW 

b)  RAINFALL 

c)  TEMPERATURE 

d)  EVAPORATION 

e)  SNOWFALL 

f)  EVENT 

g)  PEAKFLOW 

h)  HOURRAIN 

Any  number  of  elements  can  be  given  for 
The  temperature  command  is  also  used  to 
water  temperature  as  explained  later  m 
cards ,  Section  I.E. 


a  single  access  request, 
obtain  evaporation  pan 
the  section  on  control 


\ 
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3.  STATION 


The  STATION  command  is  used  to  request  access  to  specific 
stations.  Standard  agency  codes  are  used,  except  that  only  the 
numbers  (without  punctuation)  are  permitted. 

The  8-digit  code  of  the  U.S.  Geological  Survey  is  used  for 
the  Streamflow  and  Peak  Flow  files.  To  access  data  for  Station 
12.1695.00  the  operand  must  be  formatted  as  21169590. 

The  6-digit  codes  of  the  National  Weather  Service  is  used 
for  the  Rainfall,  Temperature,  Evaporation,  Snowfall  and  Event 
files.  To  access  data  for  station  10-6152  the  operand  must  be 
formated  as  106152. 

4  ._  LOCATION 

The  LOCATION  command  is  used  to  request  access  for  stations 
in  a  geographic  region  called  a  geographic  location  block. 

A  4-digit  number  defines  each  1-degree  quadrangle,  spec¬ 
ified  by  the  latitude  and  longitude,  respectively,  of  the  south¬ 
east  corner.  (If  the  longitude  exceeds  100,  only  the  last  two 
digits  are  used.)  This  quadrangle  may  then  be  divided  into  four 
30-minute  quadrangles  number  1,  2,  3  and  4  taking  in  order  the  SE, 
SW,  NW  and  NE  quadrants.  Each  quadrangle  thus  obtained  may  in 
turn  be  subdivided  repeatedly  until  the  desired  accuracy  is  ob¬ 
tained.  HISARS  uses  a  10-digit  code  to  define  locations  in 
storage.  This  is  sufficient  to  define  an  area  60/64  minutes  square 
or  approximately  one  square  mile  (see  Fig.  A  1). 

The  operand  for  the  LOCATION  command  may  contain  from  1  to 
10  digits,  referring  to  all  stations  which  start  with  the  same 
group  of  digits.  If  for  example  a  6-digit  location  code  451634 
were  used,  all  stations  would  be  gccessed  in  the  15-minute  quad¬ 
rangle  bounded  on  the  south  by  45  45*  and  on  the  east  by  116 

30'.  Similarly,  a  ^-d^git  gode  4  would  result  in  access  to  all 
stations  between  40  and  50  latitude,  regardless  of  longitude. 
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This  page  is  left  blank. 


Figure  A 


Location  codes  as  used  in  HISARS 


5.  BASIN 


The  BASIN  command  identifies  requests  by  river  basin.  The 
codes  being  used  are  those  used  by  the  National  Weather  Service. 
Figure  A  2  shows  the  river  basin  codes  for  Idaho. 

Future  plans  call  for  a  more  detailed  breakdown  by  sub-basins 
but  this  has  not  been  implemented  yet. 


6._  REGION 

The  REGION  command  identifies  requests  by  climatological  re¬ 
gion.  The  code  used  is  a  two  character  code  devised  by  the  Na¬ 
tional  Weather  Service  (See  Figure  A  5). 


7. _  COUNT' Y_ 

The  COUNTY  command  is  used  to  access  stations  by  county.  The 
operand  consists  of  a  string  of  one  or  more  characters.  All  sta¬ 
tions  are  retrie\Ted  which  have  the  same  character  string  in  the 
name  of  the  county.  Unlike  other  comparisons,  however,  the  string 
does  not  have  to  occur  at  the  beginning  of  the  county  name,  but 
can  occur  anywhere  in  the  name.  Thus,  for  example,  for  the  operand 
BO  all  stations  in  BOnner,  BOise,  Boundary  and  CariBOu  counties 
would  be  accessed. 


8.  ELEVATION 


The  ELEVATION  command  is  used  to  access  stations  within  a 
given  range  of  elevations.  The  operand  is  given  in  the  form  MIN 
TO  MAX.  For  example,  the  command  card  ELEVATION  2000  TO  2500  will 
access  all  stations  between  2000  and  2500  feet  elevation.  Stations 
with  elevations  equal  to  either  the  upper  or  lower  limit  will  be 
included . 

The  format  of  the  operand  is  quite  free,  the  only  requirement 
being  at  least  one  blank  between  the  two  limits.  The  limits  can 
also  be  punched  with  a  decimal  point,  and  several  decimal  places  if 
required.  Thus  the  operand  2000.00  2500.0  will  produce  the  same  re¬ 
sults  as  the  example  above. 

If  only  a  lower  limit  is  desired,  only  a  single  limit  need 
be  given.  A  default  upper  limit  of  100,000  feet  will  be  supplied 
automatically. 

For  certain  stations,  the  elevation  may  be  unknown  or  irrel¬ 
evant,  and  the  elevation  in  the  index  will  be  left  blank.  These 
blank  values  are  not  interpreted  as  zeros,  and  such  stations  can¬ 
not  be  accessed  using  the  ELEVATION  command. 
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Figure  A  2  River  basin  codes  Used  in 
HISARS  (tentative  only). 


f/ff 


Drainage  Basin 

Bear 

Boise 

Clearwater 
Coeur  d’Alene 
Kootena i 
Lost 
Palouse 
Payette 
Pend  Oreille 
St.  Joe 
Salmon 
Snake 
Owyhee 
Spokane 


Code 

1 

2 

3 

4 

5 

6 

7 

8 

9 

10 
11 
12 

13 

14 
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Figure  A  3  Region  codes  used  in  HISARS 


Panhandle 

North  Central  Prairies 
North  Central  Canyons 
Central  Mountains 
Western  Valleys 
Southwestern  Highlands 
Central  Plains 
Northeastern  Valleys 
Upper  Snake  Plains 
Eastern  Highlands 


01 

02 
0  3 
04 
OS 
06 
07 
08 
09 
1  0 


mi  >04 
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9  ARIA 

The  AREA  command  is  used  to  access  streamflow  stations  by 
drainage  area*  The  format  and  usage  of  the  operand  is  identical 
to  that  of  the  ELEVATION  command  given  above,  except  that  the 
limits  are  of  drainage  areas  in  square  miles.  Again,  if  only  a 
lower  limit  is  required,  a  single  limit  is  sufficient. 

Blank  values  are  more  common  for  drainage  are-as.  These 
occur  for  springs,  and  for  stations  with  varying  drainage  areas 
such  as  swamps*  Such  stations  cannot  be  accessed  using  the  area 
command  * 

10  *_  PERIOD 

The  period  for  which  records  are  included  in  the  data  files 
is  recorded  in  the  associated  index  file.  Since  records  for  most 
files  are  Stored  by  month,  the  beginning  and  ending  of  _  a  period 
of  record  is  stored  by  year  and  month.  Each  period  which  is  com¬ 
plete,  but  which  is  preceded  and  followed  by  a  missing  month,  is 
defined  as  a  period  of  record,  and  is  indexed  by  beginning  and 
ending  dates  and  length  in  months.  Up  to  100  such  periods  can  be 
accessed  for  a  single  station;  if  there  are  more,  only  the  last 
100  are  indexed  and  accessible  by  the  system. 

For  the  files  which  contain  data  obtained  at  irregular  inter¬ 
vals,  such  as  snowfall,  the  index  assumes  a  single  period  of  re¬ 
cord,  with  the  first  and  last  months  being  the  months  m  which  the 
first  and  last  days  of  record  occurred.  The  number  of  months  is 
replaced  by  the  number  of  records  in  the  file.  There  is  no  way  to 
tell  from  the  index  whether  the  record  is  complete  during  the  per¬ 
iod* 


If  an  access  group  is  given  without  a  PERIOD  command,  the  en 
tire  period  of  record  is  accessed  for  every  station . included  by 
the  group*  The  PERIOD  command  may  be  used  to  restrict  the  length 

of  period  for  which  records  are  to  be  accessed. 

The  format  of  the  operand  is  BEGIN  TO  END,  where  BEGIN  and 
mb  are  months  in  the  form  Month/Year.  For  example,  the  command 


PERIOD  6/1939  TO  12/1940 


would  limit  access  to  records  in  the 
1940  inclusive*  The  format  requires 
preceded  by  month  and  followed  by  year 
The  same  format  is  required  for 
words  in  between  are  irrelevant. 


period  June  1939  to  December 
the  slash  ('/')  immediately 
without  intervening  blanks 
BEGIN  and  END  but  spacing  and 


For  some  purposes,  a  complete  period  of  record  may  be 
If  the  word  COMPLETE  is  added  at  the  end  of  the  preceding 
with  at  least  one  intervening  blank,  only  stations  having 
records  for  the  entire  period  specified  will  be  accessed, 
feature  could  be  used,  for  example,  to  obtain  averages  for 
tions  which  have  complete  records  for  a  specific  period. 


required, 
operand , 
complete 
This 

all  sta- 


-9- 


, 

- 


,  n 

Ki 


a  >w| 


11.  LIST 


The  LIST  command  directs  the  system  to  produce  certain  list¬ 
ings  of  the  accessed  data.  The  following  operand  are  permitted: 

a)  INDEX  d)  HOURLY 

b)  MONTHLY  e)  CONTENTS 

c)  DAILY 

The  INDEX  operand  indicates  that  a  listing  of  the  index  is  to  be 
produced.  The  MONTHLY  and  DAILY  operands  indicate  that  data  are 
to  be  listed  for  the  specified  time  periods. 

Listings  of  monthly  values  for  several  of  the  elements  normal¬ 
ly  include  such  summary  information  as  annual  totals,  monthly  and 
annual  averages  for  the  period,  and  the  ratio  of  the  annual  total 
to  the  annual  average  for  each  year  with  complete  records.  In  or¬ 
der  to  print  the  ratios  in  a  convenient  format,  the  data  are  actu¬ 
ally  read  twice.  If  the  ratios  are  not  required,  the  word  PARTIAL 
may  be  added  following  the  operand  MONTHLY.  Thus,  the  command 
LIST  MONTHLY  PARTIAL  will  produce  listings,  complete  except  for 
ratios,  at  noticeably  less  cost  and  should  be  used  whenever  possi¬ 
ble. 

Detailed  formats  of  output  listings  are  given  in  Section  I.D. 
The  LIST  command  has  one  option.  This  is  the  month  for  which  the 
listing  is  to  begin.  For  example,  LIST  MONTHLY  6  will  list  the 
year  with  June  as  the  first  month.  LIST  DAILY  10  will  list  one 
year's  data  beginning  on  October  1.  This  is  most  useful  for  stream- 
flow  files  where  a  wateryear  listing  rather  than  a  calendar  year 
list  is  desired.  Default  is  1  except  for  snowfall  files  where  de¬ 
fault  is  7. 

I2^  _copI 

The  COPY  command  is  provided  to  permit  users  to  copy  records 
from  the  HISARS  data  files  to  other  formats,  for  use  with  other 
languages.  Since  HISARS  files  are  not  accessible  to  FORTRAN  and 
COBOL , operands  provide  for  conversions  appropriate  to  these  lan¬ 
guages.  This  feature  is  discussed  in  detail  in  Part  III,  the 
Users'  Guide  to  the  Copying  Facilities. 

I3jl  _AND_or  OR 

The  AND  and  OR  commands  are  not  strictly  commands,  but  are 
control  words  for  the  And/Or  option.  This  option  is  described  in 
Section  I.C.2  below. 
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c. 


ACCESS  COMMAND  OPTIONS 


Several  options  are  permitted  beyond  the  standard  specifica¬ 
tions  described  in  the  previous  section.  The  options  are  designed 
to  permit  either  extension  to  the  access  facilities  or  simplifica¬ 
tion  of  the  command  format. 

1_._  The  £omp.lete_f _il£  option 

For  certain  uses  of  the  system  it  may  be  desirable  to  ac¬ 
cess  the  entire  file.  For  example,  the  user  may  wish  to  obtain  an 
index  of  all  records  in  the  files. 

This  option  is  obtained  by  using  only  an  ACCESS  card,  an 
ELEMENT  card  with  the  requested  element  or  elements  as  operands, 
and  appropriate  LIST  cards  as  required.  No  other  command  cards 
are  permitted. 

When  this  option  is  used,  the  entire  file  is  scanned,  and 
entries  for  each  station  in  order  are  processed  as  requested. 

Since  such  processing  may  be  unacceptably  extensive,  only  limited 
operations  are  permitted.  For  example,  operands  for  the  LIST  com¬ 
mand  of  INDEX  and  MONTHLY  are  permitted,  but  DAILY  is  not. 

2._  The  AND / 0  R_opt  i_on 

The  regular  access  facilities  permit  retrieval  of  records 
that  satisfy  one  or  more  criteria.  For  example,  if  the  command 
cards 


BASIN  06 
07 

COUNTY  BONNER 


are  used,  then  all  stations  that  are  either  in 
07  or  in  Bonner  County  will  be  accessed.  Note 
usecf~in  the  logical  sense. 


Basin  06  o^r  in  Basin 
that  the  word  OR  is 


OR  command  cards  could  be  inserted  between  the  command  cards 
above,  without  changing  the  results.  These  cards  are  therefore 
without  function  to  the  system,  but  may  help  the  user  to  recognize 
the  logic  of  the  retrieval  request. 


The  AND  command  introduces  the  requirement  that  in  addition  to 
preceding  criteria,  the  following  criterion  must  be  met.  For  ex¬ 
ample,  if  the  command  cards 


\ 
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BASIN  06  07 

COUNTY  BONNER 
AND 

ELEVATION  2000 
AND 

AREA  0  to  500 

are  used,  all  stations  that  are  either  in  Basin  06  or  in  Ba¬ 
sin  07  0£  in  Bonner  County  and  having  elevations  over  2000  feet 
and  having  drainage  areas  of  less  than  500  square  miles  will  be  ac¬ 
cessed.  Note  that  the  word  AND  is  used  in  the  logical  sense  also. 
This  option  permits  some  additional  flexibility  in  making  access 
requests . 

3 ._  Opti  o_na^l_abbr_evia  t  i_on 

Abbreviation  of  the  command  words  and  certain  operands  is 
possible.  The  user  who  is  just  becoming  acquainted  with  the  sys¬ 
tem  should  probably  use  the  whole  words  as  given,  but  a  user  with 
more  experience  may  prefer  the  abbreviated  forms. 

Abbreviation  is  possible  because  the  system  when  reading  the 
command  cards  reads  only  enough  of  each  word  to  identify  it  unique¬ 
ly.  Thus,  to  distinguish  between  the  commands  ELEMENT  and  ELEVA¬ 
TION,  only  the  first  four  letters  need  be  read.  Four  letters  are 
sufficient  to  uniquely  identify  all  other  commands.  The  allowable 
abbreviations  are: 


a) 

Command  words  -  the 
given  in  Section  I . 

first 

B; 

four 

letters 

of  the  names 

b) 

Element  names  -  the 
given  in  Section  I . 

first 
B.  2  ; 

three 

letters 

of 

the  names 

c) 

List  operand  -  the 
given  in  Section  1. 

first 

B  .  1 1  • 

two  letters  of 

the 

names 

D.  OUTPUT  FORMATS 

This  section  contains  examples  of  the  output  that  may  be  pro¬ 
duced  by  the  access  facilities  of  HISARS.  Examples  show  the  com¬ 
mand  cards  used,  and  the  corresponding  output.  The  examples  in¬ 
clude  all  listings  that  are  now  available.  Other  listings  will  be 
implemented  as  the  need  arises. 


\ 

« 
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1.  The  output_heading  page 


A  heading  is  printed  at  the  beginning  of 
sociated  with  each  access  group.  This  contai 
name  and  version,  the  date  and  time  of  executi 
access  requests  as  recognized  by  the  system,  a 
ing  station  locations  and  location  blocks  sear 
is  produced  if  only  an  Index  listing  is  reques 
is  shown  in  Figure  A  4  ,  which  resulted  from  th 
mand  cards : 


the  output  as- 
ns  the  system 
on,  a  list  of 
nd  a  map  show- 
ched.  No  map 
ted._  An  example 
e  following  com- 


ACCESS 

ELEMENT 

STATION 

LIST 


STREAMFLOW 

15196500 

MONTHLY 


2.  Indexes  of  the  files 


AThe  command  sequence 


ACCESS 

ELEMENT 

COUNTY 

LIST 


STREAMFLOW 
SHOSHONE  KOOTENAI 
INDEX 


produced  the 


output 


shown  in  Figure  A  5  . 


Not  all  of  the  indexes  p 
der  all  headings.  An  example 
be  used  for  temperature  files 
the  information  was  not  known 

All  users  are  encouraged 
interest  to  them.  This  is  th 
contents,  period  of  record  or 


rinted  will  include  information  un 
is  drainage  area  which  would  not 


For 

any 

ot 

he 

r 

spa 

ces 

left 

blank 

at  f i  1 

e  g 

ene 

ra 

ti 

on 

time 

• 

to  obt 

ain 

in 

de 

xe 

s  0 

f  the 

fi 

1 

es  of 

only 

way 

to 

d 

et 

erm 

ine 

the 

f 

ile 

number 

of 

re 

CO 

rd 

s  and  s 

o 

fo 

r 

th . 
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* 

* 


* 


* 

* 


**** 


***** 


*  * 

*  * 

******* 
*  * 

*  * 

*  * 


*  * 

*  * 

***** 

*  • 

*  * 

*  * 


*  • 

* 

**** 

*  * 
***** 


HYDROLOGIC  INFORMATION  STORAGE  ANO  RETRIEVAL  SYSTEM 


VERSION  OF 
RUN  ON 
AT 


*** 


** 

** 


•  ** 


***** 

* 

* 

* 

* 

* 

* 

* 


DATA  ACCESS  REOUESTEO  FOR : 

l  ELEMENT  -  STREAMFLOW 
l  STREAMFLOW  STATION  -  13.1965.00 

ACTION  REOUESTEO: 

L  1ST  MONTHLY  RECORDS 


*** 


**  ** 


* 

* 


** 


* 

* 


*** 


* 


* 

* 


*  *** 

*  **********  * 
*******  * 

* 

* 

* 


* 

* 

* 

* 

* 

* 

* 

* 

* 


W  -  WEATHER  STATIONS 
S  -  STREAMFLOW  STATIONS 
M  -  MISCELLANEOUS  STATIONS 
X  -  LOCATION  BLOCKS 


************************************************************ 


Figure  A  4.  Output  heading  page 


03m/75 

10/18/75 

12:20:31 


-si- 


STREAMFLOW  STATIONS 


ST.  JOE  RIVER  AT  CALDER.  IOA 


LATITUDE  47-16-30 

LONGITUDE  116-11-15 

ELEVATION 

FT  MSL 

REGION  04 

PERIOD  OP 

RECORDS 

LENGTH,  MONTHS 

05/1911  - 

09/1912 

17 

08/1920  - 

09/1973 

638 

COEUR  O'ALENE  LAKE  AT  COEUR 

D’ALENE 

t  IDA 

LATtTUDE  47-39-55 

LONGITUDE  116-46-05 

ELEVATION 

FT  MSL 

REGION  01 

PERIOD  OF 

RECORDS 

LENGTH,  MONTHS 

00/1904  - 

10/1905 

15 

01/1906  - 

02/1906 

2 

04/  1906  - 

04/1906 

1 

06/1906  - 

04/1911 

59 

06/1911  - 

09/1917 

76 

11/1917  - 

09/  1922 

59 

11/1922  - 

09/1962 

479 

HAYDEN  CREEK  BELOW  NQPTH  FORK  HEAR 

HAYDEN  LAKE,  IDA 

LATITUDE  46-49-22 

LONGITUDE  116-39-10 

ELEVATION  2370 

FT  MSL 

REGION  01 

PERIOD  OF 

RECCROS 

LENGTH,  MONTHS 

10/1965  - 

09/19T3 

96 

RATHORUM  PRAIRIE  CANAL  AT  HUETTER. 

IDA 

LATtTUDE  47-42-35 

LONGITUOE  116-52-05 

ELEVAT  ION 

FT  MSL 

REGION  01 

PERIOD  OF 

RECORDS 

LENGTH,  MONTHS 

10/ 1960  - 

09/1973 

156 

SPOKANE  RIVER  NEAR  POST  FALL 

S,  IDA 

LATITUDE  47-42-10 

LONGITUDE  116-58-40 

ELEVAT ION 

FT  MSL 

REGION  01 

PERIOD  OF 

RECCR  DS 

LENGTH,  MONTHS 

01/1913  - 

09/1973 

729 

Figure  A  5 


PAGE 


2 


SHOSHONE 

GEOGRAPHIC  location  block 

BAStN  14-/4  AREA 


STATION  NO. 
4716-142-214 
1030  SQ  MI 


12.4145.00 


KOOTENAI 

GEOGRAPHIC  LOCATION  BLOCK 
BASIN  14-/4  AREA 


STATION  NO. 
4716-324-142 
3700  SQ  Ml 


12.4155.00 


KOOTENAI 

GEOGRAPHIC  LOCATION  BLOCK 


STATION  NO.  12.4160.00 
4616-342-412 


BASIN  14 


AREA  22  SQ  MI 


KOOTENAI 

GEOGRAPHIC  LOCATION  BLOCK 
BASIN  14  AREA 


STATION  NO.  12.4180.00 
4716-324-323 
SQ  MI 


KOOTENAI 

GEOGRAPHIC  LOCATION  BLOCK 
BASIN  14  AREA 


STATION  NO.  12.4190.00 
4716-323-321 
3840  SQ  MI 


Streamf 1 ow 


index  listing 


3.  Monthly  streamflow 
The  command  sequence 


ACCESS 

ELEMENT 

STATION 

LIST 


STREAMFLOW 

13196500 

MONTHLY 


produced  the  output  shown  in  Figure  A  6 

Values  listed  are  monthly  streamflow  totals.  Sufficient 
decimal  places  are  provided  to  print  the  correct  total  of  the 
daily  values.  Means  are  computed  for  each  month,  and  the  num¬ 
bers  of  months  used  in  these  computations  are  also  listed. 

The  annual  mean  discharge  is  obtained  as  the  sum  of  the 
monthly  mean  values  and  is  not  necessarily  equal  to  the  mean 
of  the  annual  totals.  For  those  annual  totals  which  are  com¬ 
plete  (i.e.  contain  12  months  of  data),  the  ratio  of  the  total 
to  the  annual  mean  is  computed. 

If  the  word  PARTIAL  follows  the  operand  MONTHLY,  the  mean 
annual  discharge  is  not  computed  until  the  rest  of  the  table 
has  been  printed,  so  that  the  ratios  of  the  annual  totals  to  the 
mean  cannot  be  computed.  This  processing  is  more  efficient  and 
is  recommended  unless  the  ratios  are  required. 

Mean  daily  discharge  values  in  cubic  feet  per  second  and 
in  cubic  feet  per  second  per  square  mile  are  also  given.  These 
values  are  obtained  as  the  mean  for  all  days  used  in  the  corn- 
put  at  ions  . 

A  minus  sign  to  the  right  of  a  monthly  value  indicates 
that  there  are  missing  daily  values  during  the  month.  Neither 
the  monthly  total  nor  the  recorded  daily  values  for  such  months 
are  used  in  the  computations. 

4_.  _  Daj_lll  streamflow_ 

The  command  sequence 


ACCESS 

ELEMENT 

STATION 

PERIOD 

LIST 


STREAMFLOW 

12414500 

10/1952  to  9/1953 
DAILY  10 


produced  the  output  shown  in  Figure  A  7  . 

Values  listed  are  daily  totals  in  cubic  feet  per  second. 
Since  values  are  stored  in  hundredths,  they  are  printed  this 
way,  although  for  larger  basins  these  decimal  places  are  usually 
not  used.  Monthly  totals  are  also  listed.  Note  that  this  is  a 
water  year  listing  so  the  operand  DAILY  10  will  begin  the  listing 
with  October  and  the  entire  water  year  is  then  on  one  page.  Had 
the  10  been  left  off,  two  pages  of  output  would  have  resulted. 

A  dash  indicates  that  the  daily  value  is  missing. 
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PAGE  1 


BANNOCK  CREEK  NEAR  IDAHO  CITY,  IDA  BOISE  STATIGN  NO.  13.1965.00 

TOTAL  MONTHLY  STREAMFLOW  IN  CFS-DAYS 


..  JANUARY 

FEBRUARY 

MARCH 

APRIL 

MAY 

JUNE 

JULY 

AUGUST 

SEPTEMBER 

OCTOBER 

NOVEMBER 

DECEMBER 

ANNUAL 

X  AVE 

1939 

19.55 

41.95 

96.4 

56.38 

22.65 

9.22 

4.94 

7.36 

11.18 

11.5 

10.41 

299.54 

1940 

18.  81 

24.24 

90.5 

156.8 

87.  2 

24. 88 

10.48 

4.97 

1 1 .09 

16.37 

20.13 

18.84 

484.31 

61 

1941 

18.4 

20.43 

48.2 

99 

91 

45.1 

18.36 

12.68 

11.7 

15 

379.87 

1950 

24.8 

33 

34.9 

92.7 

1951 

25.3 

52.5 

50.9 

2  85.3 

293.6 

114.4 

47.  3 

31.8 

18.  5 

36.2 

30.  8 

36.1 

1022.7 

129 

1952 

27.2 

30.  5 

39.6 

429,4 

350.6 

89.6 

34 

17.9 

15.1 

15.5 

17.6 

23.6 

1090.6 

138 

1953 

45.5 

46.4 

57.7 

179 

210.3 

219.4 

49.6 

22.8 

17.6 

18 

26.9 

25.7 

918.9 

l  16 

1954 

31 

30.2 

76 

23  3.2 

158.4 

90  .6 

51.2 

25.7 

17.3 

16.  2 

20.4 

20.3 

773.5 

98 

1955 

22 

19.2 

25.7 

62.9 

196.9 

58.4 

20 

9.8 

7.9 

14.7 

21.4 

130.1 

589 

75 

1  956 

111.0 

39.6 

90.4 

347.6 

238.6 

108.8 

40.5 

20.8 

18.  3 

29.4 

30.2 

31.5 

1107.5 

140 

1957 

25.6 

42 

104.1 

201.9 

500.2 

122 

35.4 

17.6 

14.5 

25.7 

25.9 

33.5 

1228.4 

l  55 

1  958 

2  7.4 

53.7 

73.9 

311.7 

517 

108.3 

44.  7 

18.6 

17.6 

19.9 

25.5 

28.  1 

1246.4 

1  58 

1959 

31  .6 

30 

43.7 

126.2 

128.1 

64.3 

21.9 

13.4 

22.7 

28.7 

.  23.2 

24.3 

558  .  1 

71 

I960 

23.4 

19.  7 

53.2 

206.6 

146.8 

58.4 

16 . 8 

11.2 

12.3 

14.8 

20.6 

18.  7 

602.5 

76 

1961 

15.5 

24.  3 

40.5 

70.9 

65.7 

28.6 

10.  7 

7.  2 

11.2 

14.5 

1  0.6 

21.4 

329.1 

42 

1962 

17 

19.5 

2  1.7 

169.9 

169.5 

81.6 

25.5 

12 

12.2 

2  l 

22.  6 

26.2 

598.7 

76 

1963 

16.9 

52.8 

50.1 

124.8 

l  74.9 

92.8 

25.8 

10.5 

10.2 

14.5 

20.8 

17.3 

611.4 

77 

1  964 

18.8 

17.1 

19.3 

81 

173.2 

72 

21.9 

8.9 

9.8 

11.3 

16.6 

96.6 

546.5 

69 

1965 

70.3 

89.  9 

103.3 

531.6 

377 

123.6 

40.8 

20  .6 

22.5 

24.9 

25.5 

24.  1 

1454.1 

1  84 

1  965 

31.5 

28.6 

52.7 

10  7.7 

66.8 

26.2 

11.1 

6.2 

8.1 

11.3 

15.5 

19.24 

384.94 

49 

1967 

25.41 

2  1.8 

39.3 

75.6 

156.7 

58.  1 

18.55 

6.32 

8.35 

14 

15.72 

17.15 

457 

53 

1968 

19.3 

42.95 

58.3 

72.8 

62.  2 

41.69 

12.19 

19.52 

15.73 

17.45 

29.04 

21.07  • 

412.24 

52 

1  969 

50.76 

37.5 

68.5 

480 

279 

70.5 

32.7 

14.84 

16.  1  9 

20.67 

23.96 

25.66 

1128.28 

143 

1970 

61.55 

60.  6 

114.1 

132.2 

349.9 

113.9 

46.13 

14.74 

17.  84 

24.49 

43.11 

44.68 

1023.24 

129 

1971 

80.3 

92.7 

136.8 

497 

511.  1 

120.3 

50.06 

18.46 

17.69 

27.72 

1 .84- 

1553.97 

ME»N 

35.44 

38.49 

62.51 

215.31 

223.37 

01.50 

28.95 

14.64 

14.23 

19.53 

23.41 

32.93 

NO.  OF 

MONTHS 

23 

24 

24 

24 

24 

24 

24 

24 

24 

25 

23 

23 

PERCENT 

* 

ANNUAL 

4.5 

4.9 

7.9 

27.2 

28.3 

10.3 

3.  7 

1.9 

1.8 

2.5 

3.0 

4.2 

MEAN  ANNUAL  DISCHARGE  790.37  CFS-OAYS 

MEAN  DAILY  DISCHARGE  2.17  CFS 

0. 38  CFS/SQ  MI  (  5.75  SO  MI J 


Figure  A  6.  Stream flow  file  monthly  data  listing 
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$f,  JC f  AfVfA  Af  CALOfP,  IDA 


SM0SHCW6 


12.4145.00 


/ 


i 

M 

03 

* 


195Z-SJ 


MEAN  DAILY  STREAMFlfW  IN  CFS 


October 

NOVfMSg* 

oecemser 

JAW  ART 

FEOPUARV 

MARf U 

APRIL 

MAY 

JUNE 

JULY 

AUGUST 

SEPTEMBER 

1 

342,00 

333.00 

230.00 

290.00 

5270.00 

890,00 

2040.00 

6500.00 

8660.00 

2830.00 

728.00 

494.00 

t 

338*00 

309.00 

302.00 

265.00 

394 0.00 

790,00 

1900,00 

5460.00 

lOZOO.CO 

2120.00 

702.00 

515.00 

3 

333*00 

290.00 

346,00 

294.00 

33  70.00 

790.00 

1070.00 

4050.00 

8960.00 

2 660.00 

709.00 

531.00 

4 

333*00 

279*00 

347,00 

350,00 

4210.00 

798.00 

1 790.00 

4890.00 

7880.00 

2590.00 

819.00 

499.00 

5 

320,00 

290.00 

317.00 

290.00 

3300.00 

770.00 

1920.00 

5940.00 

7750.00 

2470.00 

722 .00 

484.00 

(i 

325,00 

794,00 

298.00 

260.00 

2670.00 

735.00 

2050.00 

3200.00 

7590.00 

Z360.00 

670.00 

474.00 

1 

325*00 

293.00 

294,00 

280.00 

24  70.00 

716.00 

1960.00 

1 1 0C0.00 

7680.00 

2250.00 

634.00 

459.00 

8 

321 *00 

257.00 

30.T.00 

294.00 

2550.00 

763.00 

1  780.00 

9440.00 

7500.00 

2160.00 

670.00 

449.00 

9 

313.00 

271 *00 

2  79.00 

723.00 

2750.00 

928.00 

1530.00 

75  70.00 

6900 .00 

2100.00 

702.00 

435.00 

10 

313*00 

224.00 

279,00 

1  190.00 

1 960.00 

1210.00 

1490.00 

6160.00 

6460.00 

1970. 00 

658.00 

435  .00 

1  I 

313*00 

325,00 

275.00 

1 090.00 

1790.00 

1390.00 

1480.00 

5310.00 

6860.00 

1050.00 

599.00 

430.00 

12 

30V *00 

367,00 

321 ,00 

2770.00 

1 590. 00 

1430.00 

1480.00 

5030.00 

'  j  7800.00 

1770.00 

559.00 

426.00 

13 

3  00  *  00 

3  71  *  00 

440.00 

3290.00 

1490.00 

1  340.00 

1420.00 

5  130.00 

8600.00 

1680.00 

537.00 

4  1  1  .00 

14 

306.00 

346.00 

364.00 

2010,00 

1380.00 

1 240.00 

1320.00 

5730.00 

7500.00 

1600.00 

499.00 

393  .00 

15 

306*00 

350*00 

321.00 

1340.00 

1340.00 

1210.00 

1220.00 

6630.00 

6560.00 

1530.00 

499.00 

389.00 

15 

300*00 

339.00 

283.00 

1 130.00 

1240,00 

1  240.00 

1310.00 

7570.00 

5940.00 

1440.00 

499.  OO 

376.00 

1  1 

306.00 

307.00 

263.00 

1230.00 

1 200.00 

1  310.00 

1500.00 

8800.00 

5800.00 

1340.00 

499.00 

367. CO 

IS 

3  02.00 

290.00 

272.00 

1800,00 

1130.00 

1200.00 

1840.00 

9410.00 

5560.00 

12  70.00 

504.00 

3  71  .00 

10 

302 .00 

203. 00 

275,00 

2610.00 

990.00 

1250.00 

2 100.00 

1 0900.00 

5090.00 

12  10.00 

515.00 

362.00 

to 

302*00 

293.00 

272 .00 

2320.00 

860.00 

1270.00 

2920.00 

10900.00 

4600.00 

1  160. CO 

521.00 

371.00 

21 

302.00 

268.00 

261 .00 

2340.00 

930.00 

1230.00 

4570.00 

8710.00 

4160.00 

1120.00 

531 .00 

367.00 

22 

209,00 

208.09 

261.00 

1 81 0.00 

912. 00 

1 1 70.00 

6200.00 

7130.00 

3880.00 

1060.00 

526  . CO 

362.00 

23 

200,00 

1 50,00 

257.00 

1 890.00 

868.00 

1 1 30.00 

9650.00 

6140.00 

3740.00 

1010.00 

521.00 

371.00 

24 

200,00 

too. 00 

217.00 

2250.00 

784.00 

1 1 70.00 

10600.00 

6260.00 

3530.00 

982.00 

622.00 

402.00 

25 

704*00 

230.00 

1 60.00 

1930.00 

819.00 

1  720.00 

9180.00 

6220.00 

3350.00 

958.00 

749.00 

,  411.00 

2b 

204*00 

1 40, 00 

2  10.00 

1 670,00 

812.00 

1910.00 

8860 .00 

6580. 00 

3180.00 

950.00 

599. CO 

430.00 

21 

204.00 

100.00 

260.00 

1 400.00 

833.00 

1 840.00 

10500.00 

7500.00 

3080.00 

898.00 

576.00 

531.00 

20 

200.00 

1 20 .00 

280.00 

1 250.00 

935.00 

1920.00 

12900.00 

7680.00 

2990.00 

861.00 

570.00 

531.00 

24 

207.00 

130.00 

298.00 

1180.00 

2020.00 

10500.00 

7900.00 

2960.00 

826.00 

570.00 

521.00 

30 

313.00 

180  .00 

317.00 

1500.00 

21 70. 00 

8070 .00 

8390.00 

2880  .00 

798.00 

542.00 

407. CO 

31 

354.00 

317.00 

2110.00 

2210.00 

8  110.00 

763.00 

510.00 

total 

9650.00 

77  76.00 

8938. 00 

43169.00 

51893.00 

39776.00 

126000.00 

226090.00 

177800.00 

49186.00 

18561.00 

13004.00 

Figure  A  7.  Streamflow  file  daily  data  listing 
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5-  Monthly  listings  from  rainfall  file 


The  command  sequence 


ACCESS 

ELEMENT 

STATION 

PERIOD 

LIST 


RAINFALL 

101956 

1/1950  To  12/1972 
MONTHLY 


produced  the  output  shown  in  Figure  A  8  .  The  addition  of  the 
work  PARTIAL  would  delete  the  last  column. 

Values  in  the  table  are  totaly  monthly  precipitation 
amounts  in  inches.  The  following  special  symbols  are  used  to 
qualify  the  monthly  amounts: 

missing  values  during  month; 

*  accumulations  during  month; 

E  estimated  values  during  month. 

Only  one  symbol  is  printed  for  one  month,  and  the  symbol  is  se¬ 
lected  in  the  above  order.  Thus,  if  a  minus  sign  appears,  there 
may  also  be  accumulations  or  estimated  values  during  the  month, 
but  if  an  E  is  printed,  there  are  neither  missing  values  nor 
accumulations . 

Monthly  means  are  computed  excluding  those  months  marked 
with  a  minus  sign,  and  the  mean  annual  precipitation  is  obtained 
as  the  sum  of  the  monthly  means.  Annual  totals  are  obtained 
for  all  years,  but  the  ratio  of  the  annual  total  to  the  annual 
mean  is  obtained  only  for  years  with  no  missing  values. 

**  CAUTION  ** 

Much  rainfall  data  pre\rious  to  1970  is  not  flagged  for  miss¬ 
ing,  accumulated  or  estimated  data  .  Therefore,  the  above  symbols 
may  not  appear  in  the  listings  for  dates  before  1970. 

6.*_  Da i_l v  l^ist in£S_f rom  rainf a_ll_f i^l e 

The  command  sequence 

ACCESS 

ELEMENT  RAINFALL 
STATION  107501 

PERIOD  1/1970  to  12/1970 

LIST  DAILY 

produced  the  output  shown  in  Figure  A  9  . 

Values  in  the  table  are  daily  precipitation  amounts  in  inches. 
Amounts  are  qualified  by  the  following  special  symbols: 

amount  missing; 

*  amount  accumulated; 

E  amount  estimated; 

T  trace  reported; 

X  invalid  code  combination. 

Combinations  of  the  symbols  may  be  printed  as  appropriate. 

Monthly  totals  arc  also  printed. 
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COEUR  D’ALENE  1  E 


KOOTENAI 


STATION  NO.  10-1956 


TOTAL  MONTHLY  PRECIP ITAT ION  IN  INCHES 


JANUARY 

FEBRUARY 

MARCH 

APRIL 

MAY 

JUNE 

JULY 

AUGUST 

SEPTEMBER 

OCTOBER 

NOVEMBER 

OECEMBER 

annual 

X  AVE 

19  50 

4.69- 

2.82 

4.40 

1.06 

1.04 

2.98 

1.14 

0.95 

0.38 

4.48 

2.25 

2.63 

28.82 

1951 

4.33 

2.07 

2.06 

0.44 

1.28 

1.88 

0.86 

0.68 

0.71 

6.96 

2.49 

6.39 

31.00 

126 

1  952 

3.67 

1.54 

1.28 

0.88 

0.88 

2.25 

0.32 

0.  10 

0.52 

0.35 

0.60 

4.00 

16.47 

67 

1953 

5.32 

1.91 

1.91 

2.12 

2.29 

1.66 

0.00 

1.22 

0.38 

0.52 

3.73 

3.13 

24.  19 

99 

1954 

6.82 

1  .61 

0.86 

1.20 

1.36 

1.58 

1 .  30 

2.  83 

1.30 

1  .43 

2.45 

2.80 

25.54 

104 

1955 

l.  50 

2.16 

0.94 

2.54 

1.33 

1.82 

1  .  06 

0.00 

1.54 

4.12 

5.03 

5.25 

28.09 

1  15 

1  956 

4.51 

2.11 

2.44 

0.47 

2.83 

2.60 

1.16 

1.81 

0 .69- 

2.34- 

0.95 

2.72 

24.63 

1  957 

2.09 

2.8  3 

2.61 

1  .48 

6.43 

2.63 

0.09 

0.49 

0. 06 

3.22 

1 .64 

3.08 

27.45 

112 

1950 

4.15 

3.63 

1.33 

3.94 

0.63 

2.13 

1.13 

0.25 

0.7  1 

2.11 

4.19- 

4.02- 

28.22 

1959 

5.65 

1  .  B  4  - 

2.03 

1 . 65 

2.06 

0. 79 

0.  1  1 

0.65 

2.81 

2.53 

2.19- 

1.65 

23.  76 

1960 

1  .  57- 

2.22 

1.01- 

1.40- 

3.50- 

0.82 

0.00 

2.  17 

1.13 

1.48- 

3.42- 

0.38- 

19.10 

1961 

1.  18- 

3.38- 

2.38- 

1.39- 

2.22 

l  .05 

0.36 

0.62 

0.35 

1.53 

2 . 0  7E 

2.73- 

19.26 

1962 

0.53- 

1.13- 

1.87- 

0.13- 

1.74- 

0.73 

0.20 

1.03 

1 .04 

1.42- 

2.88- 

1.10- 

13.88 

l  963 

0.55 

2.03- 

1.39 

1.02- 

1.67 

1.66 

1.03 

0.63 

1.36 

1.45 

3.94- 

2.16- 

18.89 

l  964 

4.25E 

0.5  1- 

2.00- 

1  .  19 

0.  58 

4.01 

1.49 

2.63 

1  .65 

1 .05 

2.91 

7.85E 

30.12 

1965 

3.59- 

1.78- 

0.15 

3  .02 

1  .27 

2.36 

0.22 

3.54 

1.04 

0.26 

2.13- 

1.79 

21.15 

l  966 

4.07 

0.92 

2.51- 

0.35 

0.63 

1.47 

0.55 

0.59 

0.21 

0.82 

4.60- 

2.76- 

19.48 

1967 

4.36- 

1.05 

1.82- 

2.34 

2.18 

2.03 

0.  04 

0.00 

0.70 

3.26 

1.89 

2.74 

22.41 

1968 

2.81 

4.16 

0.95 

0.48 

2.41 

2.01 

0.35 

2.32 

2.29 

3.49 

3.26- 

3.64- 

28.17 

1969 

0.00- 

1.15- 

0.74 

2.56- 

0.00- 

2.30 

0.32 

0.00 

1.35 

1.37 

0.54 

2.2  1- 

12.54 

1970 

3.  66- 

3.2  7 

0.65- 

1  .94- 

0.47 

1 .87 

1.10 

0.32 

0.  89 

2.2  8- 

3.10- 

2.91- 

22.56 

1971 

4.01* 

1.77 

2.9B* 

i  .99* 

2.11 

4.62 

0.88 

1.90 

2.05 

1  .82 

2.64* 

4.95* 

31.72 

129 

1972 

4.37* 

2.12- 

2.79* 

2.32* 

2.33 

1.61 

0.67 

1.64 

1.21 

0.83 

1  .72 

3.35- 

24.96 

MEAN 

3.86 

2.27 

1.85 

l  .62 

1.80 

2.04 

0.66 

1.15 

1.11 

2.19 

2.21 

3.77 

ND.  OP 

MONTHS 

15 

15 

16 

17 

20 

23 

23 

23 

22 

19 

14 

13 

PERCENT 

annual 

15.8 

9.3 

7.6 

6.7 

7.4 

8.4 

2.7 

4.7 

4.6 

9.0 

9.  1 

15.4 

MEAN  ANNUAL  PRECIPITATION  24.53  INCHES 


t 


Figure  A  8.  Precipitation  file  monthly  data  listing 
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PACE  l 


POTLATCH  3  NNE 


LATAH 


10-7301 


OA1LY  PRECIPITATION  IN  INCHES 


1970 

JANUARY 

FEBRUARY 

MARCH 

APRIL 

MAY 

l 

0.40 

0.11 

2 

0.18 

0.25 

3 

0.03 

6 

5 

6 

0.21 

0.19 

0.35 

7 

0.27 

0.11 

0.02 

8 

0.08 

9 

0.47 

0.20 

0.41 

10 

0.28 

0.01 

1  1 

0.15 

12 

0.  28 

0.10 

0.  14 

13 

'  0.97 

0.71 

0.02 

14 

0.28 

0.25 

1  5 

0.60 

0.03 

16 

0.27 

0.41 

0.40 

17 

0.  08 

0.28 

18 

0.93 

19 

0.61 

0.42 

20 

0.  33 

0.  17 

21 

0.43 

22 

0.  30 

0.03 

23 

0.74 

24 

0.  73 

0.46 

25 

0.41 

0.02 

26 

0.22 

27 

0.32 

0.02 

28 

0.  02 

0.  53 

29 

0.11 

0.03 

0.13 

30 

0.04 

0.16 

31 

0.  19 

TOTAL 

7.89 

2.21 

2.61 

1.87 

1.31 

JUNE 

JULY 

AUGUST 

SEPTEMBER 

OCTOBER 

NOVEMBER 

DECEMBER 

0.03 

0.05 

0.02 

0.  15 

0.15 

0.56 

0.01 

0.20 

0.22 

0.06 

0.02 

0.01 

0.25 

0.10 

0.29 

0.92 

0.07 

0.  11 

0.01 

l 

0.42 

/ 

0.04 

0.31 

0.10 

0.28 

0.73 

0.04 

0.56 

0.59 

0.15 
0.  10 

0.27 

0.01 

0.27 

0.07 

0.22 

0.09 

0.05 

0.26 

0.09 

• 

0.04 

0.38 

0.  17 

0.20 

0.07 

0.47  » 

0.11 

0.13 
0.1 1 

0.46 

1.15 

0.25 

0.05 

0.  06 

0.01 

0.01 

\ 

1.95 

0.32 

0.26 

0.  16 

1.96 

2.29 

0.03 

1.35 

3.33 

1.38 

Figure  A  9.  Precipitation  file  daily  data  listing 
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7._  Monthly  average,  maximum  and  minimum  temperatures 


The  command  sequence 


ACCESS 

ELEMENT  TEMPERATURE 

STATION  101551 

LIST  MONTHLY 

produced  the  output  shown  in  Figure  A  10.  The  addition  of  the 
word  PARTIAL  would  delete  the  last  column. 

Values  in  the  table  are  the  average  maximum  and  minimum 
temperatures  in  degrees  Fahrenheit  for  each  month.  If  there 
are  missing  daily  maximum  temperatures  during  a  month,  a  minus 
sign  is  printed  to  the  right  of  the  average  maximum.  Similar¬ 
ly,  missing  daily  minimum  temperatures  are  identified  by  a 
minus  sign  to  the  right  of  the  average  minimum.  If  there  are 
any  estimated  values  of  either  maximum  or  minimum  daily  temper¬ 
atures,  an  E  is  printed  to  the  right  of  the  average  maximum, 
provided  that  there  are  not  also  missing  maximum  temperatures. 

Monthly  means  are  calculated  using  only  values  for  com¬ 
plete  months.  The  number  of  months  printed  is  the  number  of 
months  with  complete  minimum  temperatures. 

The  mean  annual  temperatures  are  computed  as  the  average 
of  all  complete  months.  These  values  may  be  biased  if  certain 
months  are  missing. 

The  annual  average  temperatures  are  computed  using  all  the 
monthly  averages,  and  are  therefore  subject  to  the  same  source 
of  unreliability  cited  above.  However,  the  ratio  of  the  an¬ 
nual  average  to  the  mean  annual  temperature  is  calculated  only 
for  years  with  complete  data. 


8. 


Daily,  maximum  ancf  minimum 


te  mp  er at ur es 


The  command  sequence 


ACCESS 

ELEMENT 

TEMPERATURE 

STATION 

100010 

PERIOD 

1/1951  To  12/1951 

LIST 

DAILY 

produced 

the  output  shown  in 

Values  in  the  table  are 
tures  in  degrees  Fahrenheit. 


Figure  A  11. 

daily  maximum  and  minimum  tempera- 
Missing  values  are  left  blank. 


Monthly  averages  are  also  printed.  For  months  with  missing 
days,  the  averages  are  calculated  using  the  available  data. 


**  NOTE  **  These  same  command  sequences  are  used  to 
water  temperatures  of  the  evaporation  pans  BUT  the  DD 
be  modified  as  shown  in  Section  1.5. 


obtain  the 
cards  must 


22- 


■ 

' 

-  '  . 


y 

* 

,  ”  i 


PAGE  1 


CASTIEFORO  2  N  TWIN  FALLS  STATION  NO,  10-1551 

AVERAGE  MONTHLY  MAXIMUM  ANO  MINIMUM  TEMPERATURES  IN  DEGREES  F. 


JANUARY 

FEBRUARY 

MARCH 

APRIL 

MAY 

JUNE 

JULY 

AUGUST 

SEPTEMBER 

OCTOBER 

NOVEMBER 

0ECEM8ER 

ANNUAL 

X  AVE 

1963 

74.2 

08.6 

80.6 

8  1.0 

71.3 

40.  8 

36.3 

69.9 

44.0 

49.9 

51.5 

48.9 

38.7 

20.6 

17.9 

39.9 

1964 

35.8 

37.4 

45.1 

58.6 

71.4 

75.3 

90.0 

85.3 

75.  2M 

6  8.7 

47.  8 

41.1 

61.1 

15.9 

17.5 

22.7 

30.2 

38.3 

44.6 

52.0 

48.5 

38. OM 

33.5 

25.0 

23.1 

32.5 

1965 

40.2 

48.5 

53.5 

62.9 

70. OM 

78.5 

86.  1 

5  4.6 

40. 5M 

59.5 

23.9 

23.9 

19. 3M 

3  7.0 

37. 2M 

46.0 

49.8 

29.9 

18. 4M 

31.8 

1956 

41. 2M 

42. 6M 

55. 2M 

64. 6M 

79. 3M 

79.6 

89.9 

87 .4M 

01  .8 

67. 1M 

53. 2M 

37. 1M 

65.0 

21  .8M 

20.  OM 

24. 8M 

30. 3M 

41. 2M 

47. OM 

50.1 

50. 4M 

42. 6M 

30. 5M 

29. 9M 

20. 4M 

34.2 

196? 

42. 9M 

50.  3M 

55. 4M 

55.6 

71.9 

77.7 

91 . 8M 

92.1 

82.6 

65.5 

52.6 

36.6 

64.7 

26. 2M 

24. 6M 

27. 2M 

29.6 

38. 2M 

46.2 

55. 4M 

53.3 

46.7 

34. 1M 

29.5 

17.0 

35.7 

1968 

39. 0* 

48. 5M 

59.0 

59.5 

73 ,6M 

82.2 

91.6 

80.0 

76.4 

64.0 

47.1 

39.2 

63.5 

16.  1  M 

26.  6M 

28.  1M 

29.0 

38. 8M 

48.2 

51.9 

49.1 

41.6 

31.9 

29.2 

20.  7 

34.3 

1969 

40.3 

40.0 

51.3 

6  7.0 

76.0 

77.2 

08.9 

90.  8 

81.5 

58.3 

51.5 

40.6 

63.7 

99 

2  1.5 

22.  7 

24.5 

32.8 

42.3 

47.4 

53.  1 

51.0 

43.9 

30.0 

23.4 

23.9 

34.8 

99 

1970 

40 .8 

51.9 

52.5 

56.  1 

71.5 

01.7 

08.5 

90.7 

74.1 

6  1.6 

49.0 

38.1 

63.1 

98 

25.9 

26.6 

26.8 

28.3 

38.7 

47.  1 

53.4 

53.2 

38.8 

30.3 

30.4 

18.9 

34.9 

99 

1971 

40.8 

47.  4 

50.5 

61. 4M 

72.7 

80. OM 

09.0 

91.1 

74.0 

60.5 

M 

33.7 

63.9 

22.5 

24.5 

26.1 

3  2.9M 

4  1.2 

47. 8M 

52.  5 

55.1 

38.7 

32.9 

40.7 

17.2 

36.1 

1972 

35.0 

43.0 

50.5 

60.0 

73.8 

81.7 

87.6 

87.4 

70.7 

61.3 

46.8 

32.1 

61.6 

96 

15.2 

23.9 

30.6 

3  1.5 

38.8 

48.6 

50.8 

51  .9M 

4  l  .0 

35.3 

27.1 

13.1 

34.3 

1973 

35.2 

43 . 0 

52.3 

60.7 

74.7 

82.0 

88.5 

87.6 

74.7 

65.0 

47.6 

42. 8M 

63.0 

16.7 

23.  2 

26. 3M 

3i.  e 

38.5 

44.6 

52.5 

53. 5M 

43.6 

33.8 

29.2 

27.  8M 

35.2 

MEANS  • 

38  .3 

44.5 

52.0 

60.2 

73.1 

79.0 

88.  9 

88.2 

77.5 

64. 1 

49.5 

37.2 

20.7 

23. 1 

26.1 

3  1.3 

39.6 

,46.4 

51.6 

51.7 

42.9 

33.3 

29.3 

19.0 

NO.  OF 

MONTHS 

7 

7 

5 

8 

6 

9 

10 

7 

8 

8 

9 

8 

MEAN  ANNUAL  MAXIMUM  TEMPERATURE  64.3  OEGREE S  F. 

MEAN  ANNUAL  MINIMUM  TEMPERATURE  35.3  DEGREES  F. 
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Figure  A  10 


Air  temperature  file  monthly  data  listing 
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ABERDEEN  EXP  STATION 


BINGHAM 


10-0010 


t 

NJ 

i 


DAILY  MAXIMUM  AND  MINIMUM  TEMPERATURES  IN  DEGREES  F. 


1951 


JANUARY 

FEBRUARY 

MARCH 

APRIL 

MAY 

JUNE 

JULY 

AUGUST 

SEPTEMBER 

OCTOBER 

NOVEMBER 

DECEMBER 

1 

31 

10 

13 

-12 

32 

8 

51 

28 

49 

31 

58 

36 

88 

47 

91 

61 

78 

38 

73 

40 

38 

15 

46 

26 

2 

30 

24 

23 

6 

34 

IS 

60 

25 

57 

30 

57 

33 

84 

49 

88 

61 

78 

39 

64 

44 

42 

7 

43 

27 

3 

37 

26 

37 

21 

32 

15 

64 

25 

68 

28 

63 

32 

94 

44 

82 

61 

78 

40 

59 

40 

48 

16 

30 

26 

4 

33 

17 

39 

22 

39 

22 

63 

29 

77 

42 

74 

33 

88 

55 

70 

61 

80 

40 

53 

39 

55 

22 

34 

20 

5 

30 

16 

40 

34 

38 

20 

65 

26 

80 

34 

63 

46 

91 

44 

81 

53 

83 

44 

59 

38 

50 

17 

36 

24 

6 

23 

7 

40 

32 

40 

1  3 

65 

27 

78 

47 

63 

34 

89 

42 

85 

52 

84 

48 

64 

29 

51 

13 

27 

16 

7 

20 

-3 

51 

34 

38 

31 

68 

29 

69 

46 

60 

32 

82 

39 

03 

47 

88 

41 

67 

30 

54 

10 

23 

10 

8 

24 

-l 

47 

34 

38 

22 

64 

31 

57 

4  0 

67 

31 

83 

40 

80 

45 

82 

54 

73 

32 

55 

33 

13 

-6 

9 

25 

14 

55 

31 

45 

27 

67 

42 

68 

36 

72 

35 

82 

44 

03 

44 

76 

36 

78 

30 

60 

18 

12 

-13 

10 

29 

10 

55 

31 

31 

11 

60 

31 

73 

35 

76 

37 

79 

50 

87 

45 

85 

37 

79 

33 

57 

24 

19 

0 

1  1 

33 

14 

57 

33 

32 

9 

58 

18 

72 

38 

80 

39 

72 

43 

93 

49 

77 

44 

69 

42 

54 

32 

23 

16 

12 

29 

2 

46 

30 

37 

16 

68 

22 

55 

31 

69 

54 

82 

41 

85 

49 

65 

29 

58 

38 

43 

32 

25 

19 

13 

31 

19 

38 

20 

37 

26 

74 

28 

55 

38 

75 

46 

97 

46 

83 

49 

75 

32 

58 

36 

40 

25 

24 

20 

14 

42 

25 

39 

18 

47 

29 

72 

32 

63 

27 

81 

44 

97 

50 

00 

44 

01 

34 

66 

31 

40 

30 

23 

-4 

15 

32 

22 

48 

22 

50 

31 

58 

23 

75 

31 

89 

50 

99 

45 

90 

39 

79 

43 

50 

40 

36 

20 

30 

4 

16 

33 

20 

46 

25 

49 

23 

69 

23 

73 

37 

86 

48 

98 

58 

92 

48 

86 

37 

52 

19 

31 

9 

35 

26 

17 

4  l 

24 

43 

17 

34 

1  9 

72 

38 

77 

38 

84 

47 

98 
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Figure  A  11..  Air  temperature  file  daily  data  listing 
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Month]  v  _1  i_s  t  i_n_gs_f  rom  ^the  £an  evaporation  f  i_le 
The  command  sequence 


ACCESS 

ELEMENT 

STATION 

PERIOD 

LIST 


EVAPORATION 

100010 

1/1958  To  1972 
MONTHLY 


produced  the  output  shown  in  Figure  A  12.  The  addition  of  the 
word  PARTIAL  would  delete  the  last  column. 

Values  in  the  table  are  total  monthly  evaporation  amounts  in 
inches  and  total  monthly  wind  movement  in  miles.  The  following 
special  symbols  are  used  to  qualify  values  of  both  evaporation  and 
wind  movement: 

missing  values  during  month; 

*  accumulations  during  month; 

E  estimated  values  during  month. 

Only  one  symbol  is  printed  for  one  month,  and  the  symbol  is  select¬ 
ed  in  the  above  order. 

Monthly  means  are  computed  excluding  those  months  marked 
with  a  minus  sign,  and  the  mean  annual  values  are  obtained  as  the 
sum  of  the  monthly  means.  The  number  of  months  printed  is  the 
number  of  months  with  complete  evaporation  data.  Annual  totals 
are  obtained  for  all  years,  but  the  ratio  of  the  annual  total  to 
the  annual  mean  is  obtained  only  for  years  with  no  missing  values. 

l(h  _D£i_ly_l_i siting s^  _f r om_the_pan_e vapora^t i on_f i_l e 

The  command  sequence 


ACCESS 

ELEMENT 

STATION 

PERIOD 

LIST 


EVAPORATION 

100010 

1/1958  To  12/1958 
DAILY 


produced  the  output  shown  in  Figure  A  13. 

Values  in  the  table  are  daily  evaporation  amounts  in  inches 
and  total  daily  wind  movement  in  miles.  Missing  values  are  left 
blank.  Amounts  are  qualified  by  the  following  special  symbols: 

*  amount  accumulated 
E  amount  estimated 

Only  one  symbol  is  printed  for  one  month,  and  the  symbol  is  se¬ 
lected  in  the  above  order. 

Monthly  totals  are  also  printed. 
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ABERDEEN  EXP  STATION 


o  l  ri'Ori«  n 


TOTAL  MONTHLY  EVAPORATION  IN  INCHES  AMO  WIND  MOVEMENT  IN  MILES 


JANUARY 

FEBRUARY 

MARCH 

APRIL 

HAY 

JUNE 

JULY 

AUGUST 

SEPTEMBER 

OCTOBER 

NOVEMBER 

DECEMBER 

ANNUAL 

1958 

0.00  — 

0.00- 

0.00- 

0.00- 

6.97- 

8.27- 

9.88 

8.97- 

6.2  7- 

4.40- 

0.00- 

0.00- 

44.76 

1901- 

2333- 

2364- 

3149 

2202 

2208 

179  8 

1833 

2209 

1012 

2383 

2043 

26235 

1959 

0. CO- 

0.00- 

0.00- 

0  .00- 

6.64- 

8.23- 

9.5  8- 

10.65- 

5.54- 

4.20- 

0.00- 

0.00- 

44.84 

21 13 

2  794 

3965 

392  1 

3412 

1713 

1751 

2155 

2  320 

2649 

2903 

1570 

31272 

1960 

0. GO- 

0.00- 

0.  CO- 

0.00- 

8.53 

10.62 

10.91 

9.94 

7  .08 

4.22 

51.30 

1555 

2438 

2791 

3  584 

3288 

26  18 

14  19- 

2107 

1332 

1  897 

23029 

1961 

7.91- 

9.65 

10.80 

8.25 

5.00- 

3.24- 

44.86 

2934- 

1669 

1604 

1304 

1939 

2402 

11852 

1962 

5.72- 

6.64 

3.77 

16.13 

1440- 

2015 

2919 

63  82 

1963 

5.66- 

6.07- 

10.  74 

7.91 

4.  52 

3.30- 

38.23 

2360 

2024 

1982 

1503 

1443 

2075 

11467 

1964 

7.28- 

6.65- 

10.31 

10.24 

6.76 

4.36- 

45.60 

3113- 

2694- 

2459 

2767 

2453 

2024 

15510 

1965 

6.43- 

8.47- 

9.72- 

8.06- 

5.6  2- 

4.74 

43.05 

3592- 

3  109 

2138- 

2151 

3435 

2362 

' 

16737 

1966 

9.57- 

10.03 

11.39 

10.23 

6.05- 

2.75- 

50.52 

3  73  1- 

3  196 

2259 

2  353 

242  1- 

2579 

165  39 

1967 

7.59- 

7.06- 

10.73 

10.65 

6 .77 

4.  1  5- 

46 . 95 

3203- 

1989 

2193 

2098 

1925 

2597 

14005 

l  968 

7.25- 

9.34 

11.22 

7.37 

5.88 

4.04 

45.  10 

3267- 

2  779 

2  112 

2  344 

2  340 

2502 

15344 

1969 

9.95- 

8.28 

1  1.44 

11.41 

8.28 

3.2  2- 

52.  58 

2861- 

2879 

2516 

2340 

234  7 

2990 

1  59  3  3 

1970 

7.37- 

8.72 

8.6  0- 

10.40 

6.53 

3.79- 

• 

45.41 

2982 

2458 

215  7- 

1826 

22  8  1 

2035- 

1  37  89 

1971 

6.58- 

9.11- 

9.43 

7.  30 

3.2  5- 

35.67 

3625 

2866 

2  153 

3  13  1 

3110 

146  85 

1972 

7.48- 

8.71 

11.20 

9.06- 

6.56- 

4.37- 

47.38 

3140 

2  7  73 

2977 

22  43 

2976 

2546 

16655 

1973 

7.83- 

7.  93 

3538 

35  38 

MEANS 

0.00 

0.00 

0.00 

0.00 

8.53 

9.34 

10.91 

9.58 

6.64 

4.19 

0.00 

0.00 

1834 

2616 

3378 

3553 

3068 

2483 

2165 

2090 

2296 

2462 

2643 

1807 

NO.  OF 

MONTHS 

0 

0 

0 

0 

1 
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10 

10 

9 

4 

0 

0 

PERCENT 

t 

ANNUAL 

0.0 

0.0 

0.0 

0.0 

17.4 

19.0 

22.2 

19.5 

13.5 

8.6 

0.0 

0.0 

6.1 

8.7 

11.2 
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10.1 

8.2 

7.2 
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8.1 

8.  7 

6.0 

MEAN  ANNUAL  EVAPORATION 
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49.19  INCHES 
30395  MILES 


Figure  A  12.  Pan  evaporation  file  monthly  data  listing 
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ABERDEEN  EXP  STATION 


1958 


DAILY  EVAPORATION  IN  INCHES  AND  WIND 


I 

N> 
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FEBRUARY 

MARCH 

APRIL 

MAY 

JUNE 

l 
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91 

0.13 
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Figure  A  13.  Pan  evaporation 
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MOVEMENT 

IN  MILES 

JULY 

AUGUST 

SEPTEMBER 

OCTOBER 

NOVEMBER 

OECEMBER 

0.24 

32 

0.29 

45 

55 

0.13 

51 

13 

16 

0.  1  8 

39 

29 

0.49 

158 

0.20 

37 

22 

98 

0.12 

00 

0.18 

54 

0.31 

68 

0.06 

23 

76 

139 

0.27 

37 

0.40 

61 

0.37 

56 

0.14 

13 

230 

195 

0.31 

50 

0.41 

08 

0.33 

55 

0. 1 1 

17 

126 

141 

0.34 

20 

0.43 

80 

0.25 

2  l 

0.24 

97 

133 

204 

0.32 

4 

0.  22 

40 

0.30 

19 

0.36 

211 

2  17 

100 

0.36 

96 

0.40 

40 

0.13 

1  5 

0.28 

240 

164 

19  1 

0.35 

49 

100 

0.18 

35 

0.17 

l  40 

1  06 

26 

0.39 

49 

0.27 

28 

0.28 

82 

0.19 

115 

112 

9 

0.38 

52 

0.20 

12 

0.23 

54 

0. 1  1 

31 

38 

35 

0.49 

66 

0.28 

26 

0.00 

35 

0.15 

21 

7 

77 

0.81 

266 

0.54 

61 

0.26 

233 

0.  14 

32 

100 

22 

0.28 

76 

0.33 

54 

0.27 

99 

0.17 

7 

172 

22 

0.20 

20 

0.40 

43 

0.17 

97 

0.22 

43 

92 

25 

0.30 

49 

46 

0.25 

29 

0.1  9 

77 

1  1  1 

20 

0.36 

49 

0.51 

98 

0.20 

52 

0.08 

5 

60 

1  7 

0.34 

91 

0.37 

89 

0.19 

105 

0.1  7 

73 

40 

1  3 

0.38 

69 

0.3  7 

72 

0.28 

97 

0.14 

106 

50 

34 

0.38 

80 

0.  22 

37 

0.29 

158 

0.10 

186 

52 

8 

0.39 

79 

0.  23 

7 

42 

42 

18 

10 

0.26 

15 

0.26 

36 

0.12 

30 

0.08 

22 

35 

3  l 

0.20 

15 

0.  14 

18 

0.14 

162 

0.13 

20 

98 

1  0 

0.21 

56 

16 

0.10 

117 

0.09 

48 

121 

l  5 

0.  35 

33 

0.37 

62 

0.21 

126 

0.12 

61 

78 

64 

0.41 

103 

0.38 

68 

0.19 

46 

0.14 

1  7 

15 

59 

0.18 

22 

0.37 

67 

0.13 

13 

0.18 

20 

38 

4  82 

0.29 

20 

0.46 

136 

0.20 

54 

0.10 

10 

25 

76 

0 . 36 

97 

0.39 

14  2 

0.17 

53 

0.1  1 

7 

22 

19 

0.  1  8 

32 

0.25 

68 

0.15 

43 

0.04 

23 

12 

32 

0. 1  7 

52 

0.17 

102 

0.06 

17 

253 

9  . 

88 

3.‘ 

97 

6  . 

27 

4.40 

0.00 

0.00 

L  79  8 

1833 

2209 

1812 

2383 

2043 

file  daily  data  listing 


11 . _ Mon th ly _1  is ti n g s_  f r om _t he _s no wf al  1_  f  i  le 

The  command  sequence 


ACCESS 

ELEMENT 

STATION 

LIST 


SNOWFALL 

101956 

MONTHLY 


produced  the  output  shown  in  Figure  A  14.  The  addition  of  the 
word  PARTIAL  would  delete  the  last  column.  Note  that  the  list¬ 
ing  begins  writh  July  without  the  use  of  an  additional  operand 
for  the  LIST  command. 

Values  in  the  table  are  total  monthly  snowfall  amount  in 
inches.  The  following  special  symbols  are  used  to  qualify  the 
monthly  amounts: 

missing  values  during  month; 

*  accumulations  during  month; 

E  estimated  values  during  month; 

T  Trace  total  for  month. 

Only  one  symbol  is  printed  for  one  month,  and  the  symbol  is 
selected  in  the  above  order. 

Months  during  the  period  of  record  which  are  blank  are  as¬ 
sumed  to  have  no  snowfall.  Monthly  means  are  computed  includ¬ 
ing  these  months,  but  excluding  months  marked  with  a  minus  sign. 
The  mean  annual  snowfall  is  obtained  as  the  sum  of  the  monthly 
means.  Annual  totals  are  obtained  for  all  years,  but  the  ratio 
of  the  annual  total  to  the  annual  mean  is  obtained  only  for  years 
with  no  missing  values. 

**  CAUTION  ** 

Much  snowfall  data  previous  to  1  970  is  not  flagged  as  given 
above.  Therefore,  the  listings  will  seldom  show  the  above  sym¬ 
bols  for  data  previous  to  1970. 

12.  Daily  listings  from  the  snowfall  file 

The  command  sequence 


ACCESS 

ELEMENT 

STATION 

PERIOD 

LIST 


SNOWFALL 

101956 

7/1971  To  6/1972 
DAILY 


produced  the  output  shown  in  Figure  A  15. 

Values  in  the  table  are  daily  snowfall  amounts  in  inches, 
and  snow  depth  on  ground  at  time  of  observation  in  inches.  Val¬ 
ues  are  qualified  by  the  following  special  symbols: 

M  amount  or  depth  missing; 

*  amount  accumulated 
E  amount  or  depth  estimated 
T  trace  amount  or  depth 

Combinations  of  the  symbols  may  be  printed  as  appropriate. 


Monthly  total  snowfall  amounts  are  also  printed. 
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COEUR  D’ALENE  l  E 


KOOTENAI  STATION  NO.  10-1956 

TOTAL  MONTHLY  SNOWFALL  IN  INCHES 


JULY 

AUGUST 

SEPTEMBER 

OCTOBER 

NOVEMBER 

0ECEMBER  JANUARY 

FEBRUARY 

MARCH 

APRIL 

MAY 

JUNE 

ANNUAL 

X  AVE 

40-41 

10. 0 

1.1 

9.3 

2.0 

22.4 

44 

A  1-42 

0.5 

10.1 

4.8 

13.5 

0.5 

29.4 

57 

<,2-43 

11.4 

23.4 

26.1 

13.6 

1.5 

76.0 

148 

43-44 

1  .  8 

15.7 

1.0 

18.5 

36 

44-4  5 

1  .0 

10.8 

1 . 4 

0.0 

0.0- 

13.2 

45-46 

0.0 

8  .4 

12.7 

13.3 

42.4 

83 

46-47 

12.5 

7.5- 

19.0 

l  .0 

1.0 

4  l  .0 

4  7-46 

. 

3.3 

5  .5- 

2.1- 

8.6 

2.5 

22.0 

48-4  9 

1.3 

31.3 

9.9 

28.5 

5.5 

76.5 

149 

4-5-50 

23.6 

56.9- 

8.5 

5.6 

2.0 

96.6 

50-51 

3.3 

9.1 

19.7 

8.0 

21.5 

61.6 

120 

51-52 

0.3 

6.0 

29.4 

35.3 

10.8 

5.5 

o 

* 

o 

1 

87.3 

52-53 

15.0 

10.5 

2.8 

0.  5 

l 

* 

28.8 

56 

53-54 

3.4 

56.2 

.  0 

63.6 

124 

54-55 

10. 0- 

13.0 

39.5 

3.5 

o 

. 

o 

1 

66.0 

55-56 

12.  7- 

20.3 

21  .1- 

24.8- 

7.5 

86.9 

56-57 

2.4 

4.7 

33 . 8 

17.6 

6.  8 

65.3 

128 

57-5  5 

6.8 

2.5 

1 1  .5 

l  .  5 

1.0 

0.0- 

23.3 

5  8-5'? 

3.5 

7.0 

19.0 

16.0 

45.5 

89 

59-60 

11.3 

2.0 

13.  5 

5.5 

3.0- 

35.3 

60-61 

4.0 

5.5 

10.5 

0.0- 
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Figure  A  14.  Snowfall  file  monthly  data  listing 
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Figure  A  15.  Snowfall  file  daily  data  listing 
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1_3_  Content  s__o£  th£  peak_f l_°w  f i^e 
The  command  sequence 
ACCESS 

ELEMENT  PEAKFLOW 

STATION  13337500 

LIST  CONTENTS 

produced  the  output  shown  in  Figure  A  16.  A  heading  page  to 
fy  the  codes  is  also  produced. 

The  following  codes  are  used: 


BW 

NM 

MD 

ES 

DF 

LT 

UR 

KR 


Gage  height  was  due  to  backwater 

Not  maximum  gage  height  for  water  year 

Discharge  given  is  a  maximum  daily 

Discharge  estimated  from  another  site 

Discharge  given  due  to  dam  failure 

Actual  discharge  is  less  than  indicated  value 

Unknown  effect  of  regulation  or  diversion 

Known  significant  effect  of  regulation  or  diversion 


The  data  for  this  listing,  and  the  format  of  the  listing 
obtained  from  the  U . S .  Geological  Survey. 


ident i  - 


were 
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IDAHO 
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Figure  A  16.  Annual  peak  streamflow  file  listing 


14.  Hourly  listings  from  hourly  rainfall  file 


The  command  sequence 


ACCESS 

ELEMENT 

STATION 

PERIOD 

LIST 


HOURRAIN 

456789 

3/1951  To  3/1951 
HOURLY 


produced  the  output  shown  in  Figure  A  17. 

Values  in  the  table  are  hourly  precipitation  amounts  in 
inches  for  the  hour  ending  at  the  time  shown  (on  a  24-hour  clock). 
Amounts  are  qualified  by  the  following  special  symbols: 


amount  missing; 

S  measurement  is  of  melting  snow; 
*  amount  accumulated; 

E  amount  estimated; 

T  trace  reported. 


Only  one  symbol  is  printed  for  one  hour,  and  the  symbol  is  se¬ 
lected  in  the  above  order. 


1_5^_  _Dai_ly_ljLs_t ing_s  from_hourly_  rai^nf al1l_f i_l£ 

The  command  sequence 
ACCESS 

ELEMENT  HOURRAIN 

STATION  456789 

PERIOD  1/1951  To  12/1951 

LIST  DAILY 

will  produce  output  similar  to  Figure  A  9. 

Values  in  the  table  are  total  daily  precipitation  amounts  in 
inches,  measured  from  midnight  to  midnight.  Amounts  are  quali¬ 
fied  by  the  following  special  symbols: 

--  amounts  for  entire  day  missing; 
missing  amounts  during  day; 
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Figure  A  17.  Hourly  precipitation  file  listing 


E.  JOB  CONTROL  CARDS 


Each  and  every  submission  of  a  HISARS  job  requires  several 
cards.  The  first  is  a  Job  Information  Card  (JIC)  stating  that 
disk  pack  USR001  is  to  be  mounted.  This  is  a  white  card  found 
in  the  USER  Work  Area  at  the  Computer  Center.  The  punch  cards 
are  as  shown  below: 

//jnumber  JOB  (aaa- bb- cccc , actno , 1 i nes ) , ' user ’ ,TYPRUN=HOLD 
//  EXEC  HISARS 

//SYSIN  DD  * 

-  HISARS  DATA  CARDS  - 

/* 

It  may  be  well  to  note  that  all  the  data  sets  referred  to 
by  the  HISARS  PROC  above  are  stored  on  a  private  magnetic  disc 
pack.  Since  this  pack  must  be  mounted  before  the  program  can 
be  run,  turn-around  time  may  be  expected  to  be  relatively  slow. 
Batching  of  jobs  is  desirable. 

Card  formats  for  the  job  control  language  are  specified  by 
the  system,  and  must  be  followed  rigorously.  In  particular, 
blanks  are  permitted  only  at  points  that  are  clear  in  the  example 
above,  and  not  otherwise.  The  number  of  blanks  at  any  point  is 
arbitrary,  however. 


1  _The_J0B_Card 

The  JOB  card  must  be  the  one  supplied  by  Computer  Services 
and  available  in  the  User  Work  Area.  This  card  has  already  punch¬ 
ed  on  it  the  jnumber  and  word  JOB.  aaa-bb-cccc  is  the  user's 
Social  Security  number,  actno  is  any  valid  account  number  (as¬ 
signed  by  Computer  Services),  lines  is  the  number  of  output  lines 
in  1000's  (5  =  5000  lines  output,  4000  is  default),  and  user  is 
the  user's  name.  In  addition,  a  TIME  parameter  may  also  be  punch¬ 
ed  if  more  than  60  seconds  is  required  for  execution.  TYPRUN= 
HOLD  is  required  and  must  be  punched  exactly  as  shown. 

2  _The_EXEC  Card 

The  EXEC  card  calls  the  HISARS  PROC  and  sets  up  all  required 
file  space. 


-35- 


' 


3.  The  SYS] N  card 


The  SYSIN  card  indicates  that  the  HISARS  command  cards  are 
to  follow.  The  HISARS  cards  are  thus  p]aced  between  this  card 
and  the  /*  card. 

4_._  The  /*_card 

The  /*  card  indicates  that  the  HISARS  command' cards  have 
all  been  read  and  the  job  terminated. 

S._  The  f il^e_cards 

If,  and  only  if,  water  temperatures  for  the  evaporation 
pans  are  desired,  insert  the  following  two  cards  between  the 
EXEC  and  SYSIN  cards 

//ITEM  DD  DSN= IDAHO. INDEX . PANTEMP ,DISP=SHR , UNI T=DI SK , VOL=SER=USRO 01 

/ /RTEM  DD  DSN= IDAHO. DATA. PANTEMP, DISP=SHR,UNIT=DISK , VOL=SER=USR001 

When  this  is  done,  the  air  temperature  DD  cards  are  over¬ 
ridden  and  the  air  temperature  files  cannot  be  accessed  during  that 
jobstep.  It  should  be  noted  that  these  data  are  very  few  and  very 

poor. 


II.  HISARS  USERS'  GUIDE:  THE  PROCESS  FACILITIES 

A.  INTRODUCTION 


The  processing  facilities  of  HISARS  are  designed  to  permit 
routine  types  of  analysis  on  data  elements  stored  by  the  system. 
Thus  the  prospective  user  need  not  become  involved  in  the  com¬ 
plexities  of  programming  and  data  manipulation  in  order  to  obtain 
the  practical  results  required. 

Processing  is  carried  out  on  data  identified  by  the  preced¬ 
ing  access  group.  Acquaintance  with  the  access  facilities  of 
HISARS  is  therefore  prerequisite  for  use  of  the  processing  facil¬ 
ities  (see  Section  I. A). 

Programs  have  been  selected  that  are  thought  to  cover  most 
users  routine  uses.  Suggestions  for  additional  programs  are  wel¬ 
come.  A  large  number  of  additional  programs  are  planned  and  will 
be  added  as  time  becomes  available  and  specific  needs  are  recog- 
ni zed . 

The  following  illustrate  the  combined  uses  of  the  access 
and  processing  facilities. 

Ex.  1:  To  obtain  a  statistical  summary  of  daily  rainfall  for 
all  rainfall  stations  in  Power  County. 

ACCESS 

ELEMENT  RAINFALL 

COUNTY  POWER 

PROCESS 

DAILY  STATISTICS 
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Ex.  2:  To  make  a  computation  of  minimum  flow  for  various  per¬ 
iods,  for  station  13.1850.00  and  13.3450.00  during  the 
common  period  October  1931  to  September  I960,. with  re¬ 
sults  converted  to  a  unit  area  basis. 

ACCESS 


ELEMENT 

STREAMFLOW 

: 

STATION 

1 3185000 

13345000 

PERIOD 

10/1931  To 

9/1960 

PROCESS 

MINIMUM 

FLOW  ANALYSIS 

131 85000 

AREA  =  830 

LENGTH  = 

7,30 

1 3345000 

AREA  =  517 

LENGTH  = 

7,30 

B .  THE  COMMAND  LANGUAGE 

The  following  commands  constitute  the  process  facilities 
of  HJSARS: 

PROCESS 

(Process  Request  card) 

(Optional  Parameter  cards) 

The  command  word  PROCESS  is  punched  starting  in  Column  1.  Infor¬ 
mation  in  the  Process  Request  card  must  start  in  Column  1,  but 
information  in  the  Optional  Parameter  cards  must  start  in  Column 
2  or  later. 

A  PROCESS  card  followed  by  a  Process  Request  card  and  Op¬ 
tional  Parameter  card  constitutes  a  single  process  group.  Several 
process  groups  may  follow  a  single  access  group,  in  which  case  all 
processing  is  carried  out  on  the  same  data. 

1.  The  Processing  request  card 


The  Process  Request  card  must  contain  one  or  more  names 
that  identify  the  types  of  processing  requested.  Permissible 
names  are  given  with  the  program  specifications  in  Section  II. C. 

The  only  formatting  restrictions  are  that  the  first  name  must  start 
in  Column  1 ,  and  not  more  than  one  card  may  be  used.  Information 
on  multiple  processing  requests  is  given  in  Section  II.D.l. 

2 .  _  Op  t^i  on  a  l_p  arameter_car  d 

Some  of  the  processing  programs  do  not  require  any  parameters 
for  execution,  whereas  others  require  one  or  more  parameters.  Par¬ 
ameter  requirements  are  given  in  the  program  specifications  in  Sec¬ 
tion  II. C.  The  specifications  also  list  default  values  that  will 
be  supplied  automatically  unless  replaced  by  the  user.  Thus,  if 
no  parameter  cards  are  included  in  the  access  group,  standard  sys¬ 
tem  defaults  will  be  used. 


\ 
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If  the  user  wishes  to  provide  parameter  values,  he  needs 
to  give  only  those  values  which  are  not  satisfactory  by  default. 

Two  further  options  exist: 

a)  Data  for  all  stations  are  to  be  processed  using 
the  same  values.  In  this  case,  only  one  group 
of  parameter  cards  is  used,  and  the  list  of  pa¬ 
rameters  applies  to  all  stations. 

b)  Different  parameter  values  are  required  for  each 
station.  In  this  case,  one  group  of  parameter 
cards  is  used  for  each  station,  and  the  parameters 
apply  to  that  station  (but  sec  Section  II.  D.  3  for 
optional  usage).  The  station  number  is  punched 
first  on  the  first  card,  starting  in  Column  2  or 
later,  and  the  list  of  parameters  follow.  The 
parameter  cards  must  be  ordered  so  that  the  sta¬ 
tion  numbers  are  in  the  same  order  as  retrieved 

by  the  access  group.  The  second  example  in  Sec¬ 
tion  II. A  uses  this  format. 

The  list  of  parameters  for  either  case  contains  the  identifying 
name  and  value  for  each  parameter.  Column  1  may  not  be  used,  but  the 
only  other  formatting  requirement  is  that  the  name  and  value  must 
each  be  punched  without  intervening  spaces.  The  parameters  may  be 
punched  in  any  order,  and  punctuation  between  parameters  is  option¬ 
al. 

The  list  of  parameters  will  normally  be  punched  on  a  single 
card.  However,  particularly  when  using  the  LENGTH  or  CLASS  pa¬ 
rameters,  the  length  of  the  list  may  be  too  long  for  a  single  card. 

In  this  case,  the  list  can  be  interrupted  at  any  convenient  point 
and  continued  on  the  next  card,  subject  to  two  conventions: 

a)  A  numerical  value  cannot  be  split  across  two  cards: 

b)  The  identification  of  the  parameter  being  continued 
must  be  repeated  on  the  second  and  following  cards, 
leaving  Col.  1  blank. 

An  example  of  this  usage  is  shown  in  Sec t i on  1 1  .  C .  9  below. 

C.  PROCESSING  PROGRAMS 


Following  is  a  listing  of  the  processing  programs  now  imple¬ 
mented  in  H1SARS.  For  each  program,  the  following  are  given: 

nl  NAME  -  the  standardized  name  to  be  used  on  the  Pro¬ 
cessing  Request  card; 

b)  INPUT  -  the  data  files  which  can  be  used  to  provide 
data  for  the  program; 

c)  OUTPUT  -  identification  of  output  results  obtained 
from  the  program; 

d)  OPTIONS  -  optional  features  that  are  controlled  by 
parameters.  Standard  default  values  are  also  given; 
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e)  An  example  showing  the  complete  ,set  of  HISARS  cards 
required  and  consequent  output. 

t 

Several  of  the  programs  permit  limiting  the  months  for  which 
the  analysis  is  carried  out.  Assuming  the  sequence  January  -  Decem¬ 
ber  followed  by  Annual,  processing  can  begin  with  any  month  and 
terminate  with  the  same  or  any  later  month.  The  form  of  this 
parameter  can  best  be  illustrated  by  examples: 

a)  ONLY  APRIL  TO  JULY  -  will  result  in  processing  only 
of  the  months  April,  May,  June,  July; 

b)  ONLY  MARCH  -  will  result  in  processing  only  for  March; 

c)  ONLY  ANNUAL  -  will  result  in  processing  only  for  the 
entire  year  combined,  i.e.  separate  monthly  analyses 
will  not  be.  obtained. 
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l._  ^t£t i_s_t i£aj_  £n_al£S£S_ 

NAME  -  DAILY  STATISTICS  or  MONTHLY  STATISTICS 
INPUT  -  STREAMFLOW  or  RAINFALL 

OUTPUT  -  the  following  results  are  tabulated  for  each  month: 

a)  Number  of  observations 

b)  Proportion  of  zeros 

c)  Mean 

d)  Standard  deviation 

e)  Variance 

f)  Third  moment 

g)  Fourth  moment 

h)  Serial  correlation 

OPTIONS  -  Processing  pe.riod 

Standard  Defaults  -  ONLY  JANUARY  TO  ANNUAL 

Note:  If  DAILY  STATISTICS  is  used,  the  analysis  is  made  on 

daily  values  from  the  input  files.  If  MONTHLY  STATIS¬ 
TICS  is  used,  the  analysis  is  made  on  monthly  totals. 

In  the  latter  case,  the  serial  correlation  is  between 
months,  and  the  number  of  pairs  used  for  calculation  is 
also  given.  For  streamflow  files,  months  with  missing 
daily  values  are  skipped. 

Example:  The  command  sequence 

ACCESS 

ELEMENT  RAINFALL 

STATION  100491 

PROCESS 

MONTHLY  STATISTICS 

produced  the  output  shown  in  Figure  B  1  . 
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ATLANTA  ELMORE  STATION  NO.  10-0491 

STATISTICAL  ANALYSIS  OF  MONTHLY  RAINFALL 
01/1962  TO  12/1973 


.MONTH 

NUMBER 

PROPORTION 

MEAN 

STANDARD 

VARIANCE 

THIRD 

FOURTH 

SERIAL 

OF  OBS. 

OF  ZEROS 

DEVIATION 

MOMENT 

MOMENT 

CORRELATION 

0.5830 

<  in 

JANUARY 

12 

0.0833 

4.  703  3E  *00 

3.5279E+00 

1 . 2446E  *0 1 

1 .9 1 37E  *0 1 

2 . 8969E*02 

0.0129 

(  12) 

FEBRUARY 

12 

0.0000 

2.4608E*00 

1.270 8E *00 

l • 6 148E  *00 

9.61 8  3E -0 1 

6 • 1 5  86E ♦ 00 

-0. 1041 

{  12) 

MARCH 

12 

0.0000 

1 . 9642  E*00 

9.2696E-01 

8.5926E-01 

2.0992E-01 

2.6  1C7E  +  00 

0.3644 

(  12) 

APR1  L 

12 

0.0833 

1.6167E+00 

8. 6060E-01 

7.4064E-01 

-6.09P6E-02 

1 .3431E*00 

0.2974 

(  12) 

MAY 

12 

0.0000 

1. 2550E*00 

1 .0633E*00 

1.  1305  E*00 

1 .7929E*00 

6.4892E*00 

0.1369 

(  12) 

JUNE 

12 

0.0833 

2.  168  3 E  +00 

1 .4793E*00 

2.  1 88  2  E  *00 

2.0661E-01 

9.1728E*00 

0.4991 

(  12) 

JULY 

12 

0.1667 

3.0667E-01 

3. 981 5E-01 

1.5852E-01 

3.5237E-02 

4.2080E-02 

-0.2210 

(  12) 

AUGUST • 

12 

0.0833 

9.4583E-01 

1.  13  52E  *  00 

1  •  2  8  86E*00 

2.3029E*00 

7.5081E*00 

0.2540 

(  121 

SEPTEMBER 

12 

0.0000 

1. 2025E*00 

5. 1064E-01 

2.60  75E-01 

2. 4562E-02 

1.6115E  —  01 

0.5205 

l  12) 

OCTOBER 

12 

0.0833 

1. 3283E*00 

1 . 00  6  8E  *0  0 

1 .0136E+00 

3.  2353E-0 l 

1 . 7 1 50E ♦ 00 

0.1322 

(  12) 

NOVE  M3EP. 

12 

0.0000 

3. 3967E*00 

1 . 5047E*00 

2 . 2640E  *00 

-8.  63  53E-02 

1.2  3  74E*01 

0.3439 

(  12) 

oecember 

12 

0.0000 

4. 0 1 2  5  E  +0  0 

2 • 93  2  4E  *  00 

8. 5992E*00 

4 .088  BE  *01 

3.9224E*02 

ANNUAL 

144 

0.0486 

2. 1205E*00 

2.07 10E*00 

4. 2892E*00 

1.8849E*0l 

1.6881E*02 

Figure  B  1.  Statistical  analysis  of  monthly  precipitation  data  output 


2 Frequency  nnalysis__ 

NAME  -  DAILY  FREQUENCY  or  MONTHLY  FREQUENCY 
INPUT  -  STREAMFLOW  or  RAINFALL 

OUTPUT  -  Tabulation  of  standard  statistics,  including  those 

given  in  the  statistical  summary,  as  well  as  deciles  and 
quartiles.  A  plot  of  the  cumulative  frequency  distribu¬ 
tion  is  also  printed.  There  is  separate  output  for  each 
month,  and  also  for  the  entire  year. 

OPTIONS  -  Processing  period 

RANGE  -  the  limits  of  the  frequency  plot 
Standard  Defaults  -  ONLY  JANUARY  TO  ANNUAL 

Daily  streamflow  - 
RANGE  0  To  1000 
Monthly  streamflow  - 
RANGE  0  To  10000 
\  Daily  ra ini  all  - 

'  RANGE  0  To  1 

Monthly  rainfall  - 
Range  0  To  10 

Note:  The  values  of  the  RANGE  parameter  are  the  limits  of  the 

plot  of  the  cumulative  frequency  distribution.  This 
does  not  affect  computation  of  the  statistics.  For  stream- 
flow  files,  months  with  missing  daily  values  are  skipped. 

Example:  The  command  sequence 

ACCFSS 

ELEMENT  RAINFALL 

STATION  106152 

PROCESS 

DAILY  FREQUENCY 

ONLY  FEBRUARY  RANGE  0  To  0.5 
produced  the  output  shown  in  Figure  B  2. 
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FREOUENCY 

ANALYSIS  OF  DAILY  RAINFALL  FOR 

THE  MONTH  OF 

FEBRUARY 

01/1900  TO  12/1973 

MAXIMUM  VALUE 

e 

1.40 

Six) 

m 

1.5353E402 

UP  PE®.  DECILE 

* 

0.25 

NUM3ER  OF  DBS.  * 

2090 

SI X*X> 

m 

5.6595E401 

UPPER  QUARTILE 

* 

0.09 

MEAN 

0.073 

SI X*X*X) 

m 

3. 5795E»01 

MEDIAN 

• 

0.00 

STD.  DEVIATION  « 

0.  1  50 

S ( X  *X*X*X) 

m 

2.9<.<.2E401 

L  OWE  P  QUAR  TILE 

* 

0.00 

SKEWNESS 

3 . 4W 

3RD  MOMENT 

- 

l.l 74  0  E- 02 

LOWER  DEC  ILF 

S 

0.00 

KURTOSIS 

16.267 

4  T H  MOMENT 

m 

9.8749E-03 
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Figure  B  2 


Frequency  analysis  of  daily  precipitation  data  output 


j> .  Hi^h£s_t /maximum  val_ue 

NAME  -  HIGHEST  or  MAXIMUM 
INPUT  -  RAINFALL  or  TEMPERATURE 

OUTPUT  -  Tabulation  of  the  highest  value  for  each  month 
OPTIONS  -  Processing  period 

Standard  Default  -  ONLY  JANUARY  TO  ANNUAL 


Note:  Choice  of  names  is  arbitrary.  For  temperature  files,  the 

highest  values  of  the  maximum  and  minimum  temperatures  are 
given . 


An  M  indicates  an  incomplete  month. 


Example:  The  command  sequence 


ACCESS 

ELEMENT 

STATION 

PERIOD 

PROCESS 

MAXIMUM 


TEMPERATURE 

106152 

1/1955  To  12/1972 


produced  the  output  shown  in  Figure  B5. 


4_. __  Lowes t /minimum  value 

NAME  -  LOWEST  or  MINIMUM 
INPUT  -  TEMPERATURE 

OUTPUT  -  Tabulation  of  the  lowest  value  for  each  month. 

OPTIONS  -  Processing  period 

Standard  Default  -  ONLY  JANUARY  TO  ANNUAL 

Note:  Choice  of  names  is  arbitrary.  For  temperature  files,  the 

lowest  values  of  the  maximum  and  minimum  temperatures  are 
given . 

Example:  The  command  sequence 


ACCESS 

ELEMENT 

PERIOD 

STATION 

PROCESS 

MINIMUM 


TEMPERATURE 
1/1955  To  12/1972 
106152 


would  produce  output  similiar  in  appearance  to  Figure  B  3  . 
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MOSCCW-UNIV  OP  IOAHO  LATAH  STATION  NO.  10-6152 


HIGHEST  DAILY  MAXIMUM  AND  MINIMUM  TEMPERATURES  IN  DEGREES  F. 


JANUARY 

FEBRUARY 

MARCH 

APRIL 

MAY 

JUNE 

JULY 

AUGUST 

SEPTEMBER 

OCTOBER 

NOVEMBER 

DECEMBER 

ANNUAL 

1955 

43 

47 

54 

68 

75 

94 

97 

94 

95 

73 

57 

51 

97 

36 

34 

39 

41 

52 

58 

66 

64 

55 

51 

43 

38 

66 

1  956 

49 

49 

59 

79 

86 

85 

93 

99 

87 

69 

57 

52 

99 

37 

35 

40 

50 

57 

53 

67 

65 

60 

47 

43 

40 

67 

1957 

42 

53 

60 

80 

83 

88 

94 

90 

91 

75 

54 

50 

94 

32 

40 

41 

48 

66 

60 

63 

56 

58 

53 

40 

38 

66 

1958 

47 

63 

63 

69 

90 

93 

98 

98 

95 

80 

55 

58 

98 

36 

48 

40 

44 

56 

63 

6  3 

65 

57 

52 

42 

4  t 

68 

1959 

5  1 

47 

58 

70 

83 

87 

102 

97 

92 

71 

62 

49 

102 

39 

37 

41 

50 

58 

57 

68 

59 

66 

51 

41 

36 

68 

1  960 

48 

48 

72 

72 

82 

85 

10  3 

95 

89 

82 

55 

48 

103 

37 

37 

44 

47 

56 

57 

65 

58 

55 

52 

39 

35 

65 

1961 

46 

54 

61 

71 

87 

96 

98 

109 

79 

79 

57 

46 

109 

40 

42 

45 

4  B 

52 

59 

63 

69 

51 

51 

40 

36 

69 

1962 

51 

58 

57 

79 

70 

89 

95 

96 

38 

c  80 

60 

5  1 

96 

36 

38 

41 

52 

50 

52 

60 

59 

54 

49 

45 

40 

60 

l  96  3 

4  4 

56 

67 

74 

8  l 

90 

88 

95 

./  92 

85 

63 

42 

95 

3  7 

41 

42 

46 

56 

57 

56 

63 

60 

52 

48 

32 

63 

I  964 

46 

45 

67 

63 

83 

82 

96 

90 

82 

82 

60 

51 

96 

37 

3? 

42 

47 

56 

58 

63 

60 

50 

50 

45 

39 

63 

1  965 

50 

56 

67 

72 

81 

86 

9  5 

98 

79 

80 

65 

52 

98 

38 

36 

37 

51 

52 

53 

62 

68 

50 

52 

43 

41 

68 

1966 

49 

49 

70 

71 

90 

8  2M 

90 

100 

94 

78 

57 

48 

100 

36 

33 

45 

47 

53 

53  M 

5  8 

69 

62 

50 

44 

40 

69 

1967 

52 

55 

53 

62 

80 

86 

103 

100 

98 

75 

57 

4  8 

103 

38 

41 

40 

39 

58 

60 

69 

62 

62 

52 

47 

35 

69 

1  968 

49 

61 

64 

79M 

83 

89 

9  7 

92 

90 

72 

56 

53 

97 

37 

44 

48 

45M 

50 

57 

59 

54 

56 

47 

42 

35 

59 

1  96  9 

42 

42 

65 

76 

83 

89 

94 

98 

92 

73 

57 

47 

98  • 

35 

34 

43 

49 

57 

62 

61 

57 

59 

45 

42 

38 

62 

1970 

46 

54 

53 

60 

83 

94 

95 

99 

84 

83 

60 

49 

99 

3  7 

39 

4  0 

33 

5  l 

72 

62 

66 

55 

50 

40 

39 

72 

1971 

58 

56 

54 

69 

82 

88 

96 

100 

85 

GO 

55 

44 

100 

44 

37 

38 

44 

51 

57 

63 

65 

54 

52 

43 

32 

65 

19  72 

46 

56 

65 

70 

85 

89 

9  3 

101 

86 

73 

52 

52 

101 

34 

44 

43 

42 

55 

60 

63 

67 

52 

45 

43 

38 

67 

PERIOD 

58 

63 

72 

80 

90 

96 

103 

109 

98 

85 

65 

58 

44 

48 

48 

52 

66 

72 

69 

69 

66 

53 

48 

41 

- 

HIGHEST 

MAXIMUM 

109  DEGREES  F. 

HIGHEST 

MINIMUM 

72  DEGREES  F. 

Figure  B  3.  Highest  daily 

maximum 

and  minimum  temperature  output 

5.  Extreme  values 


NAME  -  EXTREME 
INPUT  -  TEMPERATURE 

OUTPUT  -  Tabulation  of  the  extreme  values  for  each  month. 
OPTIONS  -  Processing  period 

Standard  Default  -  ONLY  JANUARY  TO  ANNUAL 


Example : 


The  command  sequence 


ACCESS 

ELEMENT 

PERIOD 

STATION 

PROCESS 

EXTREME 


TEMPERATURE 
1/1955  To  12/1972 
106152 


would  produce  output  similiar  in  appearance  to  Figure  B  3  . 


_6._  Rank_ord£r i_n£ 

NAME  -  RANK  ORDER 
INPUT  -  STREAMFLOW 

OUTPUT  -  Listing  of  the  n  largest  amounts  and  their  dates  ranked 

from  largest  to  smallest,  where  n  is  five  times  the  number 
of  years. 

OPTIONS  -  Processing  period 

Standard  Default  -  ONLY  JANUARY  TO  ANNUAL 

Note:  The  default  processing  period  is  the  entire  period  of  re¬ 

cord. 

Missing  data  values  are  ignored. 

Example:  The  command  sequence 

access 

ELEMENT  STREAMFLOW 

STATION  15357500 

PROCESS 
RANK  ORDER 

produced  the  output  shown  in  Figure  B  4 . 
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SOUTH  FORK  CLEARWATER  RIVER  NEAR  ELK  CITY,  IOA 


IOAHO 


STATION  NO.  13.3375.00 


LARGEST  OAILY  STREAMFLOW  IN  DESCENDING  ORDER  (CFSI 
10/1944  TO  09/1973 
ANNUAL 


3700.00 

5/29/1948 

2410.00 

5/  3/1971 

2100.00 

4/23/1956 

1950.00 

4/24/1965 

1860.00 

36  70.00 

6/  9/1964 

2410.00 

5/12/1971 

21 00.00 

4/24/1956 

1950.00 

4/26/1965 

1860.00 

1390.00 

5/22/1948 

2400.00 

5/14/1972 

2100.00 

5/ L  7/  1964 

1950.00 

5/21/1970 

1850.00 

3090.00 

6/  9/1964 

2390.00 

5/20/1964 

2100.00 

5/21/1972 

1950.00 

5/30/1972 

1850. OC 

30)0.00 

5/23/1948 

2390  .00 

5/21/1964 

2090.00 

5/22/1967 

1940.00 

5/  22/  1964 

1850.00 

2950.00 

5/17/1972 

2380.00 

5/11/1971 

2080.00 

5/18/19  70 

1940.00 

5/  2/1971 

1850.00 

2930.00 

5/16/197? 

2370.00 

4/21/1965 

2080.00 

5/10/1972 

1930.00 

5/  5/1947 

1840.00 

2900.00 

5/27/1948 

2350.00 

5/19/1972 

2070.00 

6/  4/1964 

1930.00 

5/22/ 19  57 

1830.00 

2390.00 

5/4/ 1971 

2330.00 

5/14/19  71 

2060.00 

6/  1/1948 

19  30  .00 

5/  26/  1  9  70 

1820.00 

2890.00 

5/  5/1971 

2330.00 

5/  0/1972 

2060.00 

4/23/1965 

1930.00 

5/23/1972 

1820.00 

28  20.00 

5/26  /1  948 

2320.00 

4/29/1965 

2050.00 

6/  5/1964 

1920.00 

5/  1.3/  1949 

1820.00 

2310.00 

5/29/1948 

2320.00 

5  /  9/1972 

2053.00 

5/16/1971 

1920.00 

5/16/1964 

1810.00 

2800.  CO 

5/21/1948 

2280.00 

6/  7/1964 

2  C  5  0 . 0  0 

5/22  /  1972 

1920.00 

4/25/1965 

mo. oo 

Z790.00 

5/1  9/  I  9  72 

2260.00 

6/  3/1964 

2040.00 

5/15/1971 

1920.00 

5/25/1970 

1 91 0. 00 

2  760.00 

5/15/1972 

2250.00 

5/31/1949 

2040.00 

5/13/1972 

1910 .00 

5/  16/ 1965 

18C0.00 

2730.00 

5/23/1 940 

2250.00 

5/  2/1965 

2040.  Of) 

6/  1/1972 

191 0.00 

5/  7/1972 

1830.00 

2750.00 

5/30/1948 

2240.00 

5/19/1948 

2030.00 

5/21/1957 

1900.00 

5/  4/1947 

18CC.0C 

2  7  5  0 . 0  0 

4/30/1 945 

22 40. CO 

5/19/1970 

2030.00 

4/24/1969 

1900.00 

5/15/1949 

1900.00 

2730.00 

5/  f/1965 

2240.00 

5/20/1 970 

2020.00 

4/2  7/1955 

1900.00 

5/21/1955 

1800. GO 

2  700.00 

5/24/1948 

2200.00 

5/1 7/1948 

202  0,00 

5/24/1967 

1900.00 

4/22/1956 

1  790.00 

2620.00 

5/25/1948 

2200.00 

5/19/1964 

201 0.00 

5/31  /  I  9  72 

1900.00 

6/  7/1972 

1  790.00 

?M  0.  00 

5/13/1971 

2200.00 

4/22/1965 

2000.00 

4/20/1962 

1890.00 

5/29/1964 

1 780. OC 

■2840.00 

5/18/1948 

21)50.00 

5/23/1967 

2 CO’ O'.  00 

6/  2/1964 

1890.00 

6/12/ 1964 

1 7eo.oo 

2830.00 

5/  8/1971 

2160.00 

6/11/1964 

1990.00 

5/16/1949 

1890.00 

5/  3/1965 

I 760.00 

7510.00 

5/  0/1971 

21 60.00 

5/20/1972 

1 6  70.00 

5/  9/1947 

1890.00 

5/ 19/1967 

1760.00 

7400.00 

5/  9/1971 

2140,00 

6/  6/1964 

19  70.00 

5/28/1964 

1880.00 

5/21/1967 

1  740.00 

2470.00 

6/10/1 964 

2140.00 

4/20/1965 

1970,00 

5/24/1970 

1830.00 

5/11/1972 

1  740. OC 

2440.00 

5/19/19/1 

21 30.00 

5/18/1964 

1960.00 

5/20/1957 

18  70.00 

5/  1  8/1967 

1740.00 

2420.00 

5/  7/1971 

211 0.00 

5/23/1970 

1960.00 

4/20/1965 

18  70.00 

5/24/1972 

1740.00 

I 

Pigure  B  4,  Rank  ordering  of  daily  streamfJow  output 


5/20/1967 
5/12/1972 
4/2  5/  1956 
5/3  0/1964 
5/1 7/1965 
5/22/1)  70 
5/12/1949 
5/1 5/1965 
5/  3/1947 
5/1  4/  1949 
5/2  7/  1  9  70 
5/10/1947 
5/1 7/1949 
6/  1/1964 
6/  2/1948 
5/20/1949 
5/22/1955 
5/1 7/1970 
5/29/ 1972 
4/22/ 1943 
5/  6/1972 
5/  6/1947 
5/23/1957 
6/  3/1943 
5/1 4/1965 
5/  3/1947 
5/31/1964 
4/2  3/1969 
4/2  5/1969 
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7.  Mass  analysis 


NAME  -  MONTHLY  MASS  ANALYSIS  or  MONTHLY  MASS  FLOW  ANALYSIS 

INPUT  -  STREAMFLOW  or  RAINFALL 

OUTPUT  -  A  plot  through  time  of  the  accumulated  total. 

OPTIONS  -  SCALE  -  the  units  per  inch  of  plot 

INTERVAL  -  the  number  of  time  units  per  line  of  plot 
RATE  -  a  specified  constant  rate 
Standard  Defaults  -  INTERVAL  =1 

RATE  =  0 

Monthly  streamflow  -  SCALE  =  100000 
Monthly  rainfall  -  SCALE  =  10 

Notes : 

a)  SCALE  -  the  units  are  volume  units  equivalent  to  the 
data  units.  The  user  is  cautioned  against  selecting 
too  small  a  value  for  SCALE,  since  the  axis  labeling 
will  repeat  so  often  that  the  plot  will  not  be  visible. 

b)  INTERVAL  -  This  parameter  may  be  used  to  reduce  the 
length  of  the  graph,  particularly  for  daily  values. 
Corresponding  detail  will  be  lost. 

c)  RATE  -  This  parameter  is  designed  primarily  for  stream- 
flow  analysis  by  the  Rippl  method,  but  it  could  also  be 
used  for  other  purposes  such  as  the  effect  of  moving  a 
rain  gage.  If  the  value  is  0,  only  the  basic  plot  is 
produced.  If  the  value  is  greater  than  0,  the  follow¬ 
ing  additional  output  is  produced: 

i)  Plots  of  a  constant  rate,  extending  across 
periods  of  deficient  accumulation. 

ii)  Values  of  the  deficiencies,  listed  along 
the  right  margin  in  scientific  notation. 

d)  The  name  MONTHLY  MASS  FLOW  ANALYSIS  applies  only  to  the 
streamflow  file.  The  other  name  may  be  used  with  any 
file. 

Examples:  The  command  sequence 

ACCESS 

ELEMENT  STREAMFLOW 

STATION  12414500 

PROCESS 

MONTHLY  MASS  ANALYSIS 

SCALE  =  1000000  INTERVAL  =  3 


A  portion  of  the  output  is  shown  in  Figure  B  5. 
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Figure  R  5 


Mass  curve  of  monthly  streamflow  output 


8_.  _M£x_imum_/m  i_n_imum_f  l_ow  _ana]_ys_i£ 

NAME  -  MAXIMUM  FLOW  ANALYSIS  or  MINIMUM  FLOW  ANALYSIS- 

INPUT  -  STREAMFLOW 

OUTPUT  -  A  listing  of  the  average  maximum/minimum  flows  for  each 
of  up  to  10  period  lengths  in  days  for  each  year  in  the 
period  of  record.  Results  are  in  cubic  feet  per  second 
(cfs) ,  unless  an  area  is  given  ,  in  which  case  the  re¬ 
sults  are  converted  to  cubic  feet  per  sedond  per  square 
mile  (cfsm) .  Statistics  of  the  frequency  distribution 
are  also  given,  and  the  10-year  frequency  discharge  is 
also  listed. 

OPTIONS  -  AREA  -  the  drainage  area,  if  results  in  cfs  are  de¬ 
sired  . 

LENGTH  -  lengths  of  periods  required 
Standard  Defaults  -  AREA  =  1 

LENGTH  -  7,  30,  60,  90,  120,  183,  274 

Notes: 

a)  For  maximum  flow  analysis,  a  water  year  (October  -  Septem¬ 
ber)  is  used.  For  minimum  flow  analysis,  a  climatic  year 
(April  -  March)  is  used.  Values  are  listed  only  for  com¬ 
plete  years. 

b)  If  a  value  of  AREA  is  given  which  is  not  equal  to  1,  the 
drainage  area  will  be  obtained  from  the  index  entry  for  the 
station.  If  no  area  is  listed  in  the  index,  the  given 
value  will  be  used. 

Example:  The  command  sequence 

ACCESS 

ELEMENT  STREAMFLOW 

STATION  12414500 

PROCESS 

MINIMUM  FLOW  ANALYSIS 

LENGTH  =  1,  3,  7,  15,  30,  45,  60 

produced  the  output  shown  in  Figure  B  6. 
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Figure  B  6 


SHOSHONE 


STATION  NO*  I2.4US.00 

ANALYSIS  FOR  YEAR  BEGINNING  APRIL  l 
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9.  Flow  duration  table 


NAME  -  FLOW  DURATION  TABLE 

INPUT  -  STREAMFLOW 

OUTPUT  -  A  tabulation  of  the  number  of  days  that  the  flow  was 

within  various  class  intervals  for  each  comp lete  water 
year.  A  second  table  gives  the  frequency^  of  discharge 
greater  than  or  equal  to  each  class  interval.  Class 
intervals  are  listed  in  cubic  feet  per  second,  in  cubic 
feet  per  second  per  square  mile,  and  as  a  ratio  to  the 
mean  daily  discharge. 

OPTIONS  -  CLASS  -  upper  limits  of  class  intervals 

Standard  Defaults  -  CLASS  =  1,  10,  100,  1000,  10000,  100000, 

1000000 

Notes : 

a)  A  maximum  of  32  class  inter\rals  may  be  specified. 

b)  The  drainage  area  is  obtained  from  the  index  entry  for 
the  station.  If  no  area  is  given  in  the  index,  the 
column  of  class  intervals  in  cubic  feet  per  second  per 
square  mile  will  be  omitted. 

c)  Days  with  missing  values  are  not  counted. 

Example:  The  command  sequence 

ACCESS 

ELEMENT  STREAMFLOW 

STATION  12414500 

PROCESS 

FLOW  DURATION  TABLE 

CLASS  70  100  150  200  250  300  400  500  700  1000  2000 

CLASS  2500  3000  4000  5000  7000  10000  15000  20000 

produced  the  output  shown  in  Figure  B  7. 
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6.3 

9 

700 

1331 

7029 

64 . 1 

0.  7 

0. 

3 

19 

20000 

10 

10 

0.1 

19.4 

8.4 

10 

1000 

2148 

5698 

52.0 

1 . 0 

0. 

4 

DO  A  INAGE  ARFA 

1030 

SO  MI 

F  i  gure 

B 

7. 

Flow 

duration  analysis 

output 

— 


' 


10.  Flow  duration  curve 


NAME  -  FLOW  DURATION  CURVE 
INPUT  -  STREAMFLOW 

OUTPUT  -  A  plot  of  the  frequency  of  discharge  greater  than  or 

equal  to  given  rates  plotted  in  cubic  feet  per  second, 
cubic  feet  per  second  per  square  mile,  and  as  a  ratio  to 
mean  discharge. 

OPTIONS  -  CLASS  -  upper  limits  of  class  intervals 

Standard  Defaults  -  CLASS  =  1,  10,  100,  1000,  10000,  100000, 
1000000 

Notes:  (same  as  for  the  flow  duration  table,  II. C. 9. 

Example:  The  command  sequence 

ACCESS 

ELEMENT  STREAMFLOW 

STATION  12414500 

PROCESS 

FLOW  DURATION  CURVE 

CLASS  70  100  150  200  250  300  400  500  700  1000  2000 
CLASS  2500  3000  4000  5000  7000  10000  15000  20000 

produced  the  output  shown  in  Figure  B  8. 

11.  Interstation  correlation 


NAME  -  CORRELATION 
INPUT  -  RAINFALL 

OUTPUT  -  Tabulations  of  cross  correlations  between  daily  values  for 
each  pair  of  up  to  10  stations,  with  the  number  of  pairs 
of  days  used  in  the  calculations.  Results  are  listed  separ¬ 
ately  for  each  month. 

OPTIONS  -  PROCESSING  PERIOD 

Standard  Default  -  ONLY  JANUARY  TO  ANNUAL 

Example:  The  command  sequence 

ACCESS 

ELEMENT  RAINFALL 

STATION  100491  101663  102385  108676 

PERIOD  07/1966  To  12/1973 

PROCESS 

CORRELATION 

ONLY  MAY 

produced  the  output  shown  in  Figure  B  9. 
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ST.  JOE  RIVER  AT  CAtOER,  IDA 
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♦ - ♦ - ♦ 


10000.00  + - * 


1000.00+ 


100.00 


X 
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Figure  B  8 


Flow  duration  curve  output 


CORRELATION  ANALYSIS  OF  DAILY  RAINFALL  -  MAY 
07/1966  TO  12/1973 


STATIONS 

0491 

1663 

2  385 
°6  76 

• 

• 

10-0491 
10-1663 
10-2385 
l 0-8676 

ATLANTA 

CHALL  IS 

DEADWOOO  OAM 
STANLEY 

0491 

1663 

2385 

8676 

0491 

1 .0000 

0.3402 

155 

0.6737 

155 

0.5050 

93 

1663 

1  .0000 

0.3543 

2  17 

0.4729 

155 

2385 

1 . 0000 

0.7882 

155 

6676 

l  .0000 

ELMORE 

CUSTER 

VALLEY 

CUSTER 


Figure  B  9. 
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correlation 


analysis 


output 


1.2^  _Temperal:ure_occurrences 


NAME  -  OCCURRENCES 
INPUT  -  TEMPERATURE 


OUTPUT  - 

■  A  tabulation  of  the  number  of  days  that  the  temperature 
exceeded  various  threshold  amounts  for  each  complete 
year.  The  mean  number  of  occurrences  per  year  is  also 

OPTIONS 

given. 

-  Processing  period 

THRESHOLD  -  the  threshold  in  degrees  F. 

Standard  Defaults  -  ONLY  JANUARY  TO  ANNUAL 

THRESHOLD  80 

Notes : 

a) 

A  maximum  of  10  threshold  values  may  be  specified 

b) 

If  a  processing  period  is  specified,  only  records  during 
the  processing  period  must  be  complete. 

EXAMPLE : 

The  command  sequence 

ACCESS 

ELEMENT 

STATION 

TEMPERATURE 

106152 

PROCESS 

OCCURRENCES 

THRESHOLD  60  65  70  75  80  85  90 
produced  the  output  shown  in  Figure  B]0. 
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MOSCOW-UNIV  OF  lOAHO  LATAH  STATION  NO*  10-6152 

NUMBER  OF  DAYS  TEMPERATURE  ABOVE 


YEAR 

60  DEGREES 

65  DEGREES 

70  DEGREES 

75  DEGREES 

80  OEGREES 

85  DEGREES 

90  DEGREES 

95  DEGREES 

100  OEGREES 

1955 

143 

125 

94 

74 

61 

41 

20 

3 

0 

1956 

161 

144 

117 

90 

65 

36 

15 

4 

0 

1957 

159 

144 

131 

98 

59 

30 

3 

0 

0 

1958 

177 

155 

123 

97 

83 

58 

26 

4 

0 

1  959 

152 

123 

88 

68 

45 

31 

1  1 

6 

1 

1960 

185 

150 

121 

94 

66 

37 

2  l 

8 

2 

1961 

157 

140 

122 

98 

77 

50 

33 

17 

6 

1962 

164 

129 

109 

e6 

52 

25 

13 

1 

0 

l  963 

176 

153 

126 

102 

60 

39 

15 

0 

0 

1  96  4 

163 

126 

95 

67 

37 

15 

1 

1 

0 

1  96  5 

1  76 

144 

105 

71 

41 

28 

1  0 

2 

0 

l  96  7 

152 

139 

121 

105 

84 

54 

26 

15 

l 

1969 

164 

138 

1  1  l 

90 

62 

31 

4 

1 

0 

1  970 

143 

12  1 

107 

93 

73 

5  1 

20 

3 

0 

1971 

15  1 

130 

104 

79 

56 

43 

30 

8 

0 

1972 

162 

139 

107 

78 

61 

32 

14 

4 

1 

1973 

162 

130 

1  1  7 

91 

67 

46 

27 

4  ' 

0  . 

MEAN 

160.67 

134.18 

106.58 

80.01 

55.25 

31.69 

13.13 

3.27 

0.33 

NUMBER  OF  COMPLETE  YEARS  67 


Figure  B  10.  Air  temperature  occurrences  output 


13  Snowfall  occurrences 


NAME  -  OCCURRENCES 

INPUT  -  SNOWFALL 

OUTPUT  -  A  tabulation  of  the  number  of  days  that  the  snowfall 
was  equal  to  or  exceeded  a  threshold  amount  during 
snow  season  (assumed  Sept.  1  -  Aug.  31),  the  dates 
of  the  first  and  last  snowfall  of  this  magnitude,  and 
the  depth  of  snow  on  the  ground  on  the  first  day  of 
December,  January,  February  and  March.  Averages 
of  these  amounts  are  also  given. 

OPTIONS  -  THRESHOLD  -  the  threshold  amount  in  inches 
Standard  Default  -  THRESHOLD  1 


Notes : 


a)  Only  one  threshold  value  may  be  specified 

b)  In  calculating  the  average  depth  of  snow  on 

the  ground  for  the  various  dates,  days  for  which 
the  depth  was  missing  are  not  counted. 

Example:  The  command  sequence 

ACCESS 

ELEMENT  SNOWFALL 

STATION  101956 

PROCESS 
OCCURRENCES 

produced  the  output  shown  in  Figure  B  11. 
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COE  17^  D'ALENE  t  E 


KOOTENAI 


STATION  NO.  10-1956 


SNOWFALL 

MUM  OF  DAYS  SNOWFALL 

FIRST  SNOWFALL 

LAST  SNOWFALL 

DEPTH  OF 

SNOW 

ON  FIRST 

DAY  OF 

SEASON 

>«  1.0  INCH 

>*  1.0  INCH 

>-  1.0  INCH 

DEC 

JAN 

FEB 

MAR 

1948/49 

24 

11/30/1948 

3/16/1 949 

1 

20 

22 

15 

1947/50 

29 

12/12/1949 

5/  6/1950 

H 

23 

10 

1950/51 

22 

11/20/1950 

3/11/1951 

5 

l 

1951/52 

31 

11/14/1951 

3/19/1952 

24 

22 

18 

1952/53 

11 

12/  1/1952 

2/16/1953 

2 

2 

1953/54 

15 

12/  2/1953 

2/  19/1954 

1  8 

1954/55 

13 

12/29/1954 

3/10/1955 

H 

2 

16 

1955/56 

26 

11/  2/1955 

3/  9/1956 

1 

0 

5 

H 

1956/57 

24 

l l /I 6/1 986 

3/17/1957 

22 

5 

1957/58 

•  10 

10/22/1957 

2/  5/1958 

1958/59 

12 

11/18/1958 

2/25/1959 

1959  /60 

13 

11/12/1959 

3/14/1 960 

M 

M 

1960/61 

9 

11/10/1960 

3/  13/  1961 

M 

M 

M 

1961/62 

19 

11/  3/1961 

3/  5/1962 

M 

H 

6 

1962  / 6  3 

5 

12/20/1962 

2/  14/1963 

M 

12 

1963/64 

22 

12/  9/1963 

4/16/1964 

2 

4 

1964/65 

22 

11/12/1964 

2/14/1 965 

10 

5 

1965 /66 

12 

1  1  /2  5/1  965 

3/21/1966 

M 

H 

2 

t  966  / 67 

14 

11/  9/1966 

3/30/1967 

1967/63 

11 

1 1  /2  9/1  967 

2/17/1968 

0 

11 

1968/69 

12 

11/16/1968 

2/26/1969 

M 

H 

H 

l 969/70 

21 

12/  9/1  969 

4/ 26/1970 

16 

7 

M 

1970/71 

13 

l  1/2  7/1  970 

2/25/1971 

H 

l 

19  71/72 

25 

10/3 1/1971 

3/28/1972 

M 

7 

1972/73 

8 

12/12/1972 

2/15/1973 

l 

T 

1973  /74 

10 

11/  4/1973 

12/28/1973 

l 

NUMBER  CF  YEARS  RECORDED  75 

AVE°  AGE  OBSERVED  NUM3ER  OF  DAYS 

SNOWFALL  WAS  >-  l  .0  INCH  12.92 

AVERAGE  DEPTH  ON  DECEMBER  l  : 

0.30 

AVERAGE  DEPTH  ON  JANUARY  1  : 

2.45 

AVERAGE  DEPTH  ON  FEBRUARY  l  : 

4.13 

\ 

AVERAGE  DEPTH  ON  MARCH  l  s 

1.4  7 

Figure  B  11 


Snowfall  depths  occurrences  output 


*■ 


J4_  ^DaiJy^ojr  monthly  £G£urrence 

NAME  -  DAILY  OCCURRENCES  or  MONTHLY  OCCURRENCES 
INPUT  -  RAINFALL 

OUTPUT  --  A  tabulation  of  the  number  of  time  periods  that  the 
rainfall  was  equal  to  or  exceeded  various  threshold 
amounts  for  each  complete  year.  The  mean  number  of 
occurrences  per  year  is  also  given, 

OPTIONS  -  Processing  period 

THRESHOLD  -  the  threshold  amounts  in  inches 
Standard  Defaults  -  ONLY  JANUARY  TO  ANNUAL 

Daily  -  THRESHOLD  1 
Monthly- THRESHOLD  5 

Notes : 

a)  A  maximum  of  10  threshold  values  may  be  specified 

b)  If  a  processing  period  is  specified,  only  records  dur¬ 
ing  the  processing  period  must  be  complete. 

Example;  The  command  sequence 

ACCESS 

ELEMENT  RAINFALL 

STATION  106152 

PROCESS 

DAILY  OCCURRENCES 

THRESHOLD  ,05  ,1  ,2  ,5  ,5  1  1,5  2  3 

produced  the  output  shown  in  Figure  B12, 
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MOSCOV-UNIV  OF  IDAHO  LATAH  STATION  NO,  10-6152 

NUMBER  OF  OAYS  RAINFALL  EQUALLED  OR  EXCEEOEO 


YEAP. 

0.0  INCH 

O.t  INCH 

0.2  INCH 

0.3  INCH 

0.5  INCH 

1.0  INCH 

1.5  INCH 

2.0  INCH 

3.0  INCH 

1920 

S3 

72 

49 

31 

6 

1 

1 

0 

0 

1922 

85 

57 

24 

12 

5 

1 

0 

0 

0 

1923 

91 

70 

39 

26 

9 

5 

I 

0 

0 

l  92  A 

73 

54 

34 

22 

5 

0 

0 

0 

0 

1925 

83 

65 

36 

20 

6 

0 

0 

0 

0 

1  92  6 

87 

67 

45 

30 

18 

l 

0 

0 

0 

1928 

74 

50 

26 

18 

3 

0 

0 

0 

0 

1930 

75 

57 

34 

24 

10 

0 

0 

0 

0 

193  1 

81 

59 

38 

23 

9 

1 

1 

0 

0 

1932 

103 

76 

44 

34 

14 

1 

0 

0 

0 

1933 

96 

70 

45 

33 

15 

5 

2 

0 

0 

1935 

80 

57 

32 

10 

4 

1 

0 

0 

0 

1  936 

86 

61 

26 

16 

5 

1 

0 

0 

0 

1  9  AO 

102 

8A 

58 

32 

10 

3 

0 

0 

0 

1  0  A  1 

100 

74 

44 

28 

13 

0 

0 

0 

0 

1  9  A3 

75 

55 

35 

21 

8 

1 

0 

0 

0 

l  9A  A 

6  1 

45 

26 

15 

5 

0 

0 

0 

0 

l  9A  3 

100 

79 

63 

42 

23 

3 

0 

0 

0 

1  9A9 

73 

60 

3  1 

19 

8 

0 

0 

0 

0 

1  950 

11  5 

05 

54 

33 

9 

0 

0 

0 

0 

1951 

81 

60 

40 

27 

11 

1 

0 

0 

0 

1  952 

65 

52 

28 

14 

8 

0 

0 

0 

0 

1953 

96 

65 

44 

30 

12 

2 

0 

0 

0 

1  954 

88 

74 

A  4 

27 

7 

0 

0 

0 

0 

1955 

66 

39 

20 

8 

2 

0 

0 

0 

1956 

87 

64 

37 

20 

12 

1 

0 

0 

0 

1957 

83 

62 

40 

20 

7 

0 

0 

0 

0 

1  958 

105 

80 

45 

23 

12 

0 

0 

0 

0 

1959 

92 

57 

36 

26 

13 

0 

0 

0 

0 

I960 

90 

70 

39 

23 

9 

2 

0 

0 

0  • 

1961 

11  1 

84 

47 

31 

8 

1 

0 

0 

0 

1  962 

90 

69 

41 

20 

9 

2 

0 

0 

0 

1  96  5 

74 

49 

25 

1  7 

8 

1 

0 

0 

0 

1970 

104 

86 

54 

38 

17 

0 

0 

0 

0 

197  1 

107 

8  A 

52 

36 

13 

4 

l 

*0 

0 

1972 

112 

85 

50 

31 

14 

5 

l 

0 

0 

MEAN 

89.17 

66.78 

40. 11 

24.78 

9.81 

1.25 

0.  19 

0.00 

0.00 

NUMBER  OP  COMPLETE  YEARS  36 


Figure  B  12 


Precipitation  occurrences  output 
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JS_  Hi^h/^low_occurrcnces 
NAME  -  HIGH  OCCURRENCES  or  LOW  OCCURRENCES 


INPUT  - 
OUTPUT  - 

TEMPERATURE 

A  tabulation  of  the  number  of  flays  that  the  tempera¬ 
ture  was  above/below  a  threshold  amount  for  each 

OPTIONS 

complete  year,  and  the  first  and  last  dates  of  occur¬ 
rence.  For  LOW  OCCURRENCES,  fhe  length  oT  the  period 
in  days  that  the  temperature  was  always  equal  to  or 
greater  than  the  threshold  is  gijLsp  listed. 

-  Processing  period 

THRESHOLD  -  the  threshold  in  degrees  F. 

Standard  Defaults  -  ONLY  JANUARY' TO  ANNUAL 

HIGH  -  THRESHOLD  90 

LOW  -  THRESHOLD  32 

Notes : 


a) 

Only  one  threshold  value  may  be  specified. 

b) 

If  a  processing  period  is  specified,  only  records 
during  the  processing  period  must  be  complete. 

Example : 

The  command  sequence 

ACCESS 

ELEMENT 

STATION 

TEMPERATURE 

1  0  2  3  8  S 

PROCESS 

LOW  OCCURRENCES 

produced  the  output  shown  in  Figure  B  15. 
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VALLEY 


STATION  NO,  10-2385 


OEADWOOD  OAM 


YEAR 

NUM  CF  DAYS  TEMPERATURE 

LAST  DAY 

FIRST  DAY 

LENGTH  OF  PERIOD 

BELOW  32  OEGREES 

BELOW  32  DEGREES 

BELOW  32  OEGREES 

>•  32  OEGREES 

1  03  0 

245 

7/20/1930 

8/21/1930 

31 

1  931 

270 

7/  3/1931 

8/  7/1931 

34 

1 932 

269 

7/  8/1932 

8/  6/1932 

20 

t  m 

292 

7/28/1 935 

8/  1/1935 

3 

1936 

2  74 

7/26/1936 

8/19/1936 

23 

1  °3  0 

259 

6/19/1938 

9/  2/1938 

43 

193  9 

272 

7/20/1939 

8/  6/1939 

16 

I960 

236 

7/2  7/1  940 

8/  2/1940 

5 

1942 

277 

7/  29/  1942 

6/  1/1942 

2 

1  9  A  3 

300 

7/30/1943 

8/  5/1943 

5 

1964 

2  80 

7/24/1 944 

8/  9/1944 

15 

1  94  5 

307 

7/31/1945 

8/  1/1945 

0 

1947 

238 

7/  5/1947 

8/10/1947 

35 

1  94  8 

2  54 

7/28/1948 

8/  6/1940 

8 

1  949 

251 

7/29/ 1949 

8/  0/1949 

9 

1959 

262 

7/30/1950 

9/11/1950  ( 

42 

1951 

279 

7/11/1951 

8/13/1951 

32 

1952 

277 

7/22/1952 

8/16/1952 

24 

1  953 

254 

7/21/1953 

8/  6/1953 

15 

1  9  5 

273 

7/  23/  1  954 

8/  1/1954 

8 

1  95  5 

273 

7/29/ 1955 

8/  4/1955 

5 

l  95  6 

240 

7/  1/1956 

0/  3/1956 

32 

1  °5  7 

241 

7/18/1957 

8/  2/1957 

14 

95  8 

227 

6/29/1958 

9/  3/1958 

65 

l  959 

247 

7/29/1959 

8/13/1959 

14 

1  96  2 

257 

7/20/1962 

8/23/1962 

33 

196  3 

216 

7/31/1963 

8/21/1963 

20 

1  964 

259 

7/24/1964 

8/14/1964 

20 

1965 

258 

7/23/1 965 

8/29/1965 

36 

1  96  6 

253 

7/26/  1  966 

8/12/1966 

1  6 

1967 

250 

6/14/1967 

8/  0/:967 

54 

196  8 

2  57 

7/23/1 958 

8/29/1968 

36 

1  969 

2  59 

7/  4/1969 

0/  5/1969 

31 

1970 

253 

7/31/1970 

8/  3/1970 

2 

1  97  1 

263 

7/ 12/ 19  71 

8/23/1971 

41 

1972 

2  33 

7/23/ 1972 

9/  1/1972 

39 

MEAN 

259.70 

23.22 

NUMBER  OF  COMPLETE  YEARS  3& 


Figure  B  13.  Minimum  air  temperature  occurrences  output 


D.  OPTIONAL  FEATURES 


A  number  of  options  are  available  that  add  to  the  flexibility 
of  use  of  the  process  facilities.  While  they  do  not  add  an}" 
features  not  previously  discussed,  they  do  permit  somewhat  more 
freedom  of  use. 


l_._Mul t.il)l£  processing 

In  section  II. B,  the  possibility  of  processing  one  set  of 
data  in  several  ways  was  discussed.  When  this  is  done  using  sever¬ 
al  processing  groups,  the  user  retains  control  of  the  ordering  of 
the  output. 

It  is  also  possible,  under  certain  restrictions,  to  execute 
several  processing  programs  with  a  single  processing  group.  This 
is  done  by  listing  more  than  one  name  on  the  Process  Request 
card,  and  putting  all  parameters  together  on  the  Optional  Parameter 

card . 


The  programs  are  assumed  to  fall  into  several  natural  categor¬ 
ies,  and  only  programs  which  are  in  the  same  category  may  be  used 
together.  The  categories  are: 


a) 


b) 


c) 


d) 


General  statistics 

DAILY  STATISTICS 

(DA  TIS) 

MONTHLY  STATISTICS 

(MON  TIS) 

DAILY  FREQUENCY 

(DA  FRE) 

MONTHLY  FREQUENCY 

(MON  FRE) 

HIGHEST  OR  MAXIMUM 

(H1G  or  MAX) 

LOWEST  OR  MINIMUM 

(LOW  or  MIN) 

EXTREME 

(EXT) 

RANK  ORDER 

(RAN) 

MONTHLY  MASS  ANALYSIS 

(MON  MAS) 

Flow  analysis  programs 

MONTHLY  MASS  FLOW  ANALYSIS 

(MON  MAS  FLO) 

MAXIMUM  FLOW  ANALYSIS 

(MAX  FLO) 

MINIMUM  FLOW  ANALYSIS 

(MIN  FLO) 

FLOW  DURATION  TABLE 

(FLO  DUR  TAB) 

FLOW  DURATION  CURVE 

(FLO  DUR  CUR) 

Multipl e- station  programs 

CORRELATION 

(COR) 

Occurrence  programs 

OCCURRENCES 

(OCC) 

DAILY  OCCURRENCES 

(DA  OCC) 

MONTHLY  OCCURRENCES 

(MON  OCC) 

HIGH  OCCURRENCES 

CHI G  OCC) 

LOW  OCCURRENCES 

(LOW  OCC) 

\ 

\ 
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The  occurrence  of  a  single  identifiable  name  applies  it  to 
all  possible  programs  on  the  card.  Thus,  if  the  Processing  Re¬ 
quest  card  contained 

DAILY  AND  MONTHLY  STATISTICS  AND  FREQUENCY 

four  programs  would  be  executed.  Similarly,  if  the  card  con¬ 
tained 

DAILY  AND  MONTHLY  STATISTICS  AND  MASS  ANALYSIS 

expected  results  would  be  obtained,  but  a  warning  message  would 
also  be  printed  that  the  daily  mass  analysis  was  not  yet  supported. 

Programs  are  executed  in  order  as  listed  above  regardless  of 
ordering  on  the  Processing  Request  card. 


2.  Abbreviations 


Since  the  entire  words  in  the  names  as  listed  in  Section  II.C 
are  not  required  to  determine  the  programs  uniquely,  only  short 
groups  of  letters  are  used  to  identify  the  programs.  Consequently, 
it  is  possible  for  the  user  to  use  these  abbreviations  if  desired. 

Abbreviations  of  the  processing  program  names  are  given  in 
parentheses  in  Section  II.D.l  above.  Any  occurrence  of  the  letters 
in  the  combinations  shown  will  lead  to  execution  of  the  correspond¬ 
ing  program.  Thus,  the  Process  Request  card 

DAMONTIS  F REMAX LOW  EXTRANMAS 

would  lead  to  execution  of  every  program  in  the  general  statistics 
category  (  assuming  data  appropriate  to  each  program  were  available). 

To  separate  the  two  distinct  uses  of  the  word  MAXIMUM  and 
MINIMUM,  the  word  FLO  is  searched  for  first.  If  it  is  found,  only 
combinations  in  the  flow  analysis  category  will  be  identified. 
Otherwise,  combinations  in  the  other  categories  will  be  identified. 

For  the  parameters  also,  only  the  first  three  letters  need  be 
specified.  It  should  be  stressed  that  future  additions  of  process¬ 
ing  programs  may  require  that  the  above  abbreviations  be  changed 
to  conform  with  the  names  of  new  programs.  Thus,  if  errors  occur 
because  of  the  use  of  abbreviations,  just  revert  to  using  the  full 
names . 


\ 
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III.  HISARS  USERS’  GUIDE:  THE  COPY  FACILITIES 


A.  INTRODUCTION 

The  COPY  command  is  part  of  the  access  facility  of  HISARS. 
Those  records  which  have  been  accessed  by  the  preceding  group 
of  instructions  will  be  copied  onto  an  external  da_ta  set.  As 
such,  familiarity  with  the  access  facilities  as  described  in 
the  Users'  Guide  to  the  Access  Facilities  is  prerequisite  to 
application  of  material  in  this  guide. 

The  main  purpose  of  the  COPY  facility  is  to  permit  users 
with  programs  in  other  languages  to  obtain  copies  of  the  data 
for  their  use.  Sample  applications  are  shown  for  FORTRAN  since 
users  of  that  language  would  not  otherwise  be  able  to  access 
the  data  files.  The  user  can  create  a  permanent  file  if  one 
wishes  to  repeatedly  use  the  same  data,  or  a  temporary  file 
can  be  created  that  will  be  deleted  at  the  end  of  the  job. 

The  PL/I  programmer  can  access  the  files  directly  as  any 
ISAM  file  is  accessed.  The  file  formats  are  available  upon 
request  to  the  author.  Should  the  PL/I  programmer  desire,  the 
copying  facilities  can  be  used  as  shown  in  the  example  but  ISAM 
files  will  not  result,  only  sequential.  A  utility  is  avail¬ 
able  that  will  allow  an  ISAM  copy.  Again,  the  author  should  be 
contacted . 

There  are  two  reasons  for  separating  the  guide  to  the  copy¬ 
ing  facility  from  the  rest  of  the  access  commands.  First,  the 
user  is  here  assumed  to  have  some  competence  in  a  programming 
language.  Secondly,  some  additional  job  control  language  re¬ 
quirements  are  needed  to  use  the  copying  procedure.  This  guide, 
then,  presumes  experience  in  computer  use  that  was  not  requisite 
for  the  access  guide. 

Five  operands  are  available  for  use  with  the  COPY  command: 

INTEGER,  INTEGER  FORMATTED ,  REAL,  REAL  FORMATTED  and  DIRECT. 

a)  If  the  word  INTEGER  is  used,  each  word  in  the  output 
file  will  be  a  full-word  (4  byte)  binary  integer. 

b)  If  the  word  REAL  is  used,  each  word  in  the  output 
file  will  be  a  single  precision  floating  point  number. 

c)  If  the  word  FORMATTED  is  used,  the  output  files  will  be 
written  with  format  (in  the  FORTRAN  sense).  Otherwise, 
the  files  will  be  written  without  format. 

d)  If  either  of  the  words  INTEGER  or  REAL  is  used,  output 
records  will  be  organised  as  described  in  Section  III.B 
If  the  word  DIRECT  is  used,  output  records  will  be 
organized  exactly  as  the  regular  data  files  are  organized 
(contact  the  author  for  formats),  except  that  the  indexed 
sequential  access  method  is  not  used,  the  records  being 
organized  sequentially. '  These  records  can  be  read  in 
other  languages,  and  they  contain  all  information  from 
the  data  files,  but  they  are  more  difficult  to  use  than 
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the  records  described  in  Section  1II.B.  An  example  of 
use  is  given  in  Section  lll.C.l  under  retrieval  in  FORTRAN. 


B.  OUTPUT  FILES 


1  File  Formats 


For  some  files  -  Streamf low ,  Rainfall  -  a  single  value 
is  copied  for  each  day.  For  other  files  -  Temperature,  Eva¬ 
poration  and  Snowfall  -  two  values  are  copied  for  each  day. 
Therefore,  two  different  output  file  formats  are  used.  For 
the  single  value  format,  each  record  contains  38  words,  or¬ 
ganized  as  follows: 

Word  1  -  Station  identification  number 

Word  2  -  Year 

Word  2  -  Month 

Words  4,5-  Codes  (not  implemented  yet) 

Word  6  -  Number  of  days  in  month 
Word  7-37  -  Daily  values 
Word  58  -  Monthly  total 


For  the  two-value  format,  each  record  contains  70  words. 
The  first  six  words  are  as  above,  Words  7-68  contain  daily 
values,  and  Words  69,  70  contain  monthly  summaries.  A  pair 
of  words  is  used  for  each  day,  e.g.  Words  7,  8  for  day  1, 
Words  9,  10  for  day  2,  etc.  For  each  file,  the  contents  of 
each  daily  pair  and  the  summary  pair  are: 

Temperature  - 

Daily  A  -  Daily  maximum  temperature 
Daily  B  -  Daily  minimum  temperature 
Summary  A  -  Monthly  average  maximum  temperature 

Summary  B  -  Monthly  average  minimum  temperature 

Evaporation  - 

Daily  A  -  Daily  total  wind  movement 
Daily  B  -  Daily  total  evaporation 
Summary  A  -  Monthly  total  wind  movement 
Summary  B  -  Monthly  total  evaporation 
Snowfall  - 

Daily  A  -  Daily  total  snowfall 
Daily  B  -  Depth  of  snow  on  ground 
Summary  A  -  Monthly  total  snowfall 

Summary  B  -  Blank 

In  the  following  examples,  any  place  the  dimension  (58) 
appears,  it  must  be  replaced  with  (70)  for  two-value  data. 
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Scaling  varies  according  to  the  file  item  and  operand. 
The  table  below  shows  the  scaling  used: 


File  Item 


Operand 

INTEGER  REAL 


Daily  or  monthly  streamflow 
Daily  or  monthly  rainfall 
Daily  max  or  min  temperature 
Monthly  max  or  min  temperature 
Daily  rainfall 

Daily  or  monthly  wind  movement 
Daily  or  monthly  evaporation 
Daily  or  monthly  snowfall 
Daily  snow  depth 


xl  00 
xl  00 

xlO 
xl  00 

xl  00 
xl  0 


On  output,  the  records  for  each  station  are  put  in  a  sepa¬ 
rate  file.  To  aid  in  finding  the  output  file,  supplemental 
output  is  printed.  This  consists  of  the  station  identification, 
a  statement  that  the  records  have  been  copied,  and  the  name 
of  the  file  on  which  the  copy  was  made.  Names  of  files  arc 
discussed  more  fully  in  Section  III.D. 


Files  are  copied  in  the  order  in  which  they  are  accessed. 
This  is  determined  first  by  the  order  of  the  elements  and 
second  by  the  order  of  the  stations.  In  the  example  below, 
the  streamflow  file  for  station  12.5645.00  will  be  copied  first, 
and  the  rainfall  file  for  station  10-1645  second.  This  would 
be  true  even  if  the  order  of  the  station  numbers  was  reversed. 
However,  if  the  order  of  the  elements  was  reversed,  the  rainfall 
file  would  be  written  first. 


Example:  To  copy  streamflow  and  rainfall  records  for  stations 

12.5645.00  and  10-1645  for  the  period  1949-1960. 
Output  is  to  be  in  the  form  of  fullword  floating 
point  numbers. 


ACCESS 

ELEMENT 

STATION 

PERIOD 

COPY 


STREAMFLOW 

RAINFALL 

12564500 

101645 

1/1941  to  12/1960 
REAL 


2  St_ora£e_requiirement  s^ 

The  output  format  of  copied  records  has  been  designed  to 
achieve  maximum  compatibility  for  several  languages.  Unformatted 
records  are  specified  as  variable  1 ength , bl ocked ,  with  maximum 
record  length  284  and  maximum  block  length  512S.  Formatted 
records  are  fixed  length,  blocked,  with  record  length  5S0  and 
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r  b 
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nd  on  a  24 

00 

ft. 

Records  Records  per  Records 

RECFM  per  block  LRECL  BLKSIZE  2400  foot  tape  per  track 

3330  Disk 
Pack 


Single  value  per  day 


Formatted 

FB 

8 

380 

304  0 

90,064 

32 

Unformatted 

VB 

20 

284 

3128 

220,000 

80 

Two  values  per  day 
Formatted 

FB 

8 

380 

3040 

90,064 

32 

Unformatted 

VB 

11 

284 

3128 

120,800 

44 

C.  READING  THE  COPIED  RECORDS 

After  the  records  have  been  copied,  they  can  be  read  by 
several  other  languages. 

Files  created  by  any  of  the  five  operands  can  be  read  in 
FORTRAN  or  PL/1.  A  statement  must  define  the  storage  format, 
the  REWIND  or  OPEN  statement  is  used  to  start  reading  from  the 
beginning  of  the  file,  and  the  appropriate  READ  statement  given. 


— 


j 


FORTRAN 


Nonformatted 

INTEGER  DATA (38) 
REWIND  (9) 

READ  (9)  DATA 


REAL  Data  (38) 
REWIND  (9) 
READ  (9)  DATA 


Formatted  (one  value  per  day , 
FORMAT  (38110)  or 


FORMAT  (38F10.0) 


Formatted  (2  value  per  day) 

Temperature : 

FORMAT  (  6110,6415)  or 
FORMAT  (6110, 64F5. 1) 

Evaporation^ 

FORMAT  (6110,6415)  or 
FORMAT  (6110,32  (15, F5. 2)) 

Snowfanj_ 

FORMAT  (6110,6415) 

FORMAT  (61 10, 32 (F5. 1 , 15)) 


<1 

PL/ 1 


Integer 


DCL  1  DATA1 ,2 (INFO (6) , DATA (32) FIXED  B I N  ( 3 1 ) 
DCL  IN  FILE  RECORD  INPUT; 

READ  FILE  (IN)  INTO  (DATA1 ) ; 

Real 


DCL  1  DATA1 ,  2 (INFO (6) , DATA (32)) 
FLOAT  BINARY  (21); 

DCL  IN  FILE  RECORD  INPUT; 

READ  FILE  (In)  INTO  (DATA1 ) ; 


streamflow,  rainfall) 


DCL  IN  FILE  STREAM  INPUT; 

DCL  DATA  (58)  FIXED  or  FLOAT  BIN  (38); 

GET  FILE  (IN)  EDIT  (DATA) (38-FC10) ;  38  F  (10)); 

or  GET  FILE  (IN) EDIT (DATA) (38  E(10,0,5)); 


(6  F  (10)  ,  64  F (5) ) ; 

(6  F  (10)  ,  64  F  (5,1)); 


(6  F (1 0 )  ,  64  F (5) )  ; 

(6  F (10)  ,  32  (F (5) , F (5 , 2) ) )  ; 


(6  F (10)  ,  64  F  (5) )  ; 

(6  F (10) , 32  (F (5 , 1 ) , F (5) )  )  ; 


\ 

\ 
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Direct  (evaporation  only) 


FORTRAN 

INTEGER  *  4  ID , CODE (8) , YEAR 

INTEGER  *  2  DB , STATE , BLK , MONTH , WIND ( 31 ), EVAP ( >1 ), TW , TE 
REWIND  9 

READ (9,15)  DB , STATE , I D , BLK , YEAR , MONTH , CODE , WIND , EVAP , 
TW,  TE 

15  FORMAT (2A2, 2 (A4 ,A2) ,8A4 ,64 (A2)) 


DCL  IN  FILE  RECORD  INPUT; 

DCL  I  DATA, 

2  (NDY , CODE) BIT (8) , 

2  STATION  CHAR ( 4 ) ,  2  BLK  CHAR(2), 

2  YEAR  CHAR (4) ,  2  MONTH  CHAR(2), 

2  DCIDE (52)  B IT ( 8 ) , 

2  (WIND (51 ) , EVAP ( 31 ) , TW , TE)  FIXED  BINARY (1 5) ; 
READ  FILE  (IN)  INTO (DATA) ; 


Direct  copies  of  other  files  can  be  read  using  appro¬ 
priate  modification  of  the  above  examples.  However,  it 
is  recommended  that  whenever  possible,  unformatted  records 
using  the  REAL  or  INTEGER  commands  be  used  since  it  consumes 
less  space  and  time.  Also  the  bother  and  worry  about  the 
read  format  is  eliminated. 


D .  JOB  CONTROL  REQUIREMENTS 

Job  control  requirements  for  access  have  been  described 
in  Section  I.E.  Since  output  files  are  being  created, 
additional  Job  Control  Language  (JCL)  cards  must  be  supplied 
to  define  the  output  data  sets.  These  output  file  cards 
must  be  inserted  between  the  EXEC  card  and  the  SYSIN  card. 

It  is  possible  to  create  up  to  26  output  files  in  a 
single  HISARS  run.  The  file  names  are  OUTA,  OUTB,  .  .  . ,  in 

that  order.  These  must  be  related  to  data  set  names  by  DD 
cards  in  the  job  control  language.  Examples  of  the  format 
of  such  cards  are  given  below. 

There  are  two  types  of  output  files  that  can  be  created, 
permanent  and  temporary.  A  permanent  file  may  be  kept 
after  the  end  of  the  job  for  as  long  as  the  user  wishes. 

This  requires  that  the  user  meet  certain  conventions  esta¬ 
blished  by  the  computing  center.  The  prospective  user 
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Services.  A  temporary  fi]e  it ut0  S  Wlth  Computer 

end  of  a  job.  Because  of  this  th  !‘lly  dclcted  at  the 

faciliT  °f  ti,e  computing  center  co„veee  d0eS  n0t  have  to 
facility  is  readily  available  ventions,  and  the 

data  set  will’  choose  to°cJeatl  aTe^^  need  f°r  the  sam* 
Jy,  a  user  who  ic  i  .  eate  a  Permanent  file.  c.-  •, 

a;  ‘"S'&isriiU'ssxr-x 

the*”^3 r®e°CorCtemporarvXf lies  VC  P'-Wnfmcs  .  ° 

the  use  of  FORMATTED  oneranrlc- "  •  ! }  ™dy  be  n°ted  ah0  tjiat 

feet ed?mentS  ’  copying  "o^t^^no?^^  “»»«« 


1  Permanent  Files 


Output  file  cards  required  to  create  permanent  files 
should  be  in  the  following  form : 

//OUTA  DD  DSN=aaa.bbb.ccc, UNIT-DISK, 

//  SPACE= (TRK , m) , DISP= (NEW, CATLG) 

1)  File  name  OUTA  must  always  be  used  for  the  first 

output  file.  If  additional  output  files  are  required,  names 
must  be  OUTB ,  OUTC ,  OUTZ. 

2)  The  DSN  is  usually  a  three  level  qualified  name. 

The  first  level  is  the  account  number  to  which  storage 

is  to  be  charged.  The  other  two  levels  are  identifiers 
provided  by  the  user.  The  last  level  identifier  must  be 
different  for  each  OUTA,  OUTB,  etc.  and  must  be  different 
from  any  identifier  previously  used  to  store  data.  It  is 
recommended  that  bbb  be  the  users  name,  although  this  can  be 
omitted. 

3)  In  the  SPACE  parameter,  the  number  of  tracks  required 
must  be  provided  as  an  integer.  This  may  be  calculated  as 
described  in  Section  1 1 1 . B . 2 .  For  example,  if  42  months  will 
be  stored  per  track,  and  240  months  are  to  be  copied,  5.7 
tracks  are  required,  rounded  up  to  6,  so  that  SPACE= (TRK , 6 ) . 

4)  A  user  may  also  store  data  sets  on  tape .  I n  this  case, 
UNIT=TAPE,  the  SPACE  parameter  is  left  out,  and  the  YOL=SER= 
number  is  for  a  tape.  A  JIC  card  and  a  write  label  are  also 
requi red . 

5)  Since  DCB  information  is  provided  by  HISARS,  no  such 
parameter  should  be  given  on  the  DD  card,  unless  the  DIRECT 
operand  is  used. 

6)  When  file  is  no  longer  needed,  you  must  remember  to 
DELETE  the  file  or  you  will  be  charged  for  the  space  until 
Computer  Services  purges  the  files  at  the  end  of  the  year. 

This  is  most  easily  done  using  PGM= I EFBR14 . 

2  Temporary  FiJ_e_s 

Output  file  cards  required  to  create  temporary  files 
should  be  in  the  following  form : 

//OUTA  DD  DSNAME=5§OUTA , UNI T= DISK , SPACE = (TRK ,m) ,DISP= (NEW, PASS) 

Note  that  in  this  case  a  temporary  data  set  name  is  used,  i dent i - 
fied  by  the  leading  ampersands .  The  only  variable  information 
required  is  the  number  of  tracks  in  the  space  parameter,  which 
is  calculated  as  above. 

The  user  who  wishes  to  create  temporary  files  will  be 
execut i ng  a  two- step  job,  the  first  copying  the  file,  and  the 
second  executing  the  program  which  uses  the  file. 


\ 


-75- 


' 


1 *’ 

i 


3  _FORTRAN_A£pl_i£at^ion_s 


To  illustrate  use  of  HISARS  with  FORTRAN  programs,  two 
examples  are  given  below.  These  examples  show  The  entire 
card  deck  required,  including  JCL  cards,  HISARS  commands  and 
FORTRAN  statements . 

The  first  example  produces  a  listing  of  daily  stream flow 
similar  to  that  given  in  Section  I.D.4. 

//jname  JOB 

//  EXEC  HISARS 

//OUTA  DD  UNIT=DISK,  SPACE=  (TRK  ,  1)  ,DISP=  (NEK, PASS')  ,  DSN=  f,  f,OUTA 

//SYS IN  DD  * 

ACCESS 

ELEMENT  STREAMFLOW 
STATION  12414500 
PERIOD  10/1962  to  9/1963 
COPY  INTEGER  FORMATTED 
/* 


// 

//FORT. SYS  IN 


/* 

//GO. FT1 0F001 
//GO. SYS  IN 
/* 


EXEC  FORTGCLD 
DD  * 

REAL  YEAR  (12,32) 

INTEGER  DATA  (38) 

REKIND  10 
15  FORMAT  (38110) 

DO  23  1=1,12 
READ  (10,15)  DATA 
DO  21  J= 1 , 3 2 
K  =  J  +  6 

21  YEAR  (I , J)  =  0.01 *DATA ( K) 

23  CONTINUE 

WRITE  (6,17)  YEAR 
17  FORMAT  ( 1HO , 1 2F1 0 . 2) 

END 

DD  DSN=$f,OUTA,DISP=  (OLD  , DELETE)  , UNI T= DISK 
DD  * 


The  program  could  also  look  like  this: 

REAL  YEAR  (12,32) 

INTEGER  DATA  (32)  INFO  (6) 
REKIND  10 
15  FORMAT  (58110) 

DO  23  1=1,12 

READ  (10,15)  INFO,  DATA 

DO  21  J  =  1  TO  INFO  (6) 

21  YEAR  (I  ,  J)  =  0.01  *  DATA  (J) 

23  YEAR  (1,32)  =  0.01  *  DATA  (32) 
WRITE  (6,17)  YEAR 
17  FORMAT 
END 
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Many  times,  the  user  wants  to  have  all  days  of  the  year  in 
a  single  dimensioned  variable  such  as  YEAR(366)  rather  than 
YEAR  (12,32).  This  can  be  done  as  shown  in  this  FORTRAN  example 
for  COPY  REAL  and  a  streamflow  record  12  months  long  on  a  water 
year  basis  (October  =  1) 

DIMENSION  YEAR ( 366) ,  IM0(12),  DATA  (32),  F0RM(6) 

DATA  IMO/ 1,32, 62, 9 3, 124 ,152, 183, 213, 244, 274, 505. 336/ 
REWIND  10 
L  =  0 

DO  50  I  =  1,12 
READ  (10)  FORM, DATA 
IDA  =  FORM  (6) 

DO  50  J  =  1,  IDA 
L  =  L  +  1 

50  YEAR  (L)  =  DATA  (J) 

STOP 

END 

For  files  which  may  have  missing  months  (EVAPORATION  and 
SNOWFALL) ,  only  months  with  data  are  copied  so  the  following 
strategy  must  be  used: 

DO  50  I  =  1,12 
MON  =  FORM  (5) 

IDA  =  FORM  (6) 

IYR  =  FORM  (4) 

L  =  IMO (MON) 

I F  (MOD ( I YR , 4 ) . EQ . 0 . AND . MON . GT . 2 . AND . MON . LT . 1 0 ) 

*LL  =  L  +  IDA  -1 
K  =  0 

DO  50  J  =  L , LL 
K  =  K  +  1 

50  YEAR  (J)  =  DAT  A ( K ) 


V. 


- 


The  second  example  is  used  to  calculate  and  print  monthly 
weighted  average  rainfall  computed  from  data  for  stations  10- 
4772,  10-5283  and  10-7499  with  weights  of  0.3,  0.5,  and  0.2 
respectively. 


/  / i name 
//*  EXEC 
//OUTA  DD 
// OUTB  DD 

/  /  OIITC  DD 

//SYS  IN  DD 
ACCESS 


JOB 

HISARS 

DSN=  5  5 OUTA , UNI T=D1 SK , SPACE = (TRK , 2) ,D1SP= (NEW, PASS) 
DSN=$&OUTB  ,  UNITED  I SK  ,  SPACE  =  (TRK,  2)  ,1)1  SP=  (NEW  ,  PASS) 
DSN=  ^  fjOUTC ,  UN  I  T=D1  SK ,  SPACE=  (TRK,  2)  ,DISP=  (NEW, PASS) 


ELEMENT  RAINFALL 
STATION  104772 
105283 
107499 

PERIOD  10/1951  TO  9/1956 
COPY  REAL 

/* 


//  EXEC  FORTGCLD 

//FORT. SYS  IN  DD  * 

REAL  DATAA (38) , DATAB (38) ,DATAC(38) 

REWIND  8 
REWIND  9 
REWIND  10 
DO  19  1=1,60 
READ  (8)  DATAA 
READ  (9)  DATAB 
READ  (10)  DATAC 
NYR= DATAA ( 2 ) 

NMO= DATAA (3) 

AVE=  0 . 5* DATAA ( 58 ) +0 . 5* DATAB ( 38 ) +  0 . 2  * DAT AC ( 38 ) 
19  WRITE  (6,10)  NYR , NMO , AVE 
10  FORMAT  (16,  15,F8.2) 

STOP 

END 

/* 

//GO.  FT08F001  DD  DSN=  §  6  OlITA  ,  DI  SP=  (OLD, DELETE)  ,UNIT  =  DISK 
//GO. FT09F001  DD  DSN =5 8 OUTB , DI SP= (OLD , DELETE) ,UN1T=DISK 
//GO. FTlOFOOl  DD  DSN= 5 $OUTC , DI SP= (OLD , DELETE) , UNIT=DI SK 
//GO. SYS  IN  DD  * 

/* 


From  this  example,  it  is  seen  that  the  requested  data  for 
each  station  are  on  a  separate  file.  If  there  had  been  7  stations, 
the  DD  card  would  have  to  be  named  OUTA  to  OUTG. 


£  _PL/_I.  Appl Acat_ion 

The  second  example  of  Section  5  could  look  like  'this  in 

PL/I  : 

AVE : PROC  OPTIONS (MAIN) ; 

DECLARE  (INA, INB, INC) FILE  INPUT  RECORD; 

ON  ENDFILE(INA)  GO  TO  LAST; 

DECLARE  1  DATAA,  2  (PARTI (6) , DATA (52) ) FLOAT  BINARY (21); 

DECLARE  1  DATAB  LIKE  DATAA; 

DECLARE  1  DATAC  LIKE  DATAA; 

TOP: READ  FILE(INA) INTO (DATAA) ; 

READ  FI LE( INB) INTO (DATAB) ; 

READ  FILE ( INC) INTO (DATAC) ; 

AVG= 0.5* DATAA . DATA ( 5  2 ) + 0 . 5  * DATAB . DATA ( 5  2 ) + 0 . 2  * DATAC . DATA (52); 

PUT  EDIT (DATAA. PARTI (2) , DATAA . PARTI ( 5) ,AVG) (SKIP,F(6)  , F ( 5) , F ( 8  ,  2) ) 
GO  TO  TOP; 

LAST: END  AVE; 

All  the  DD  cards  are  the  same  except  that  the  names  on  the  GO  file 
card  change  to  GO.INA,  GO. INB,  and  GO. INC. 


The  same  program  could  be  done  without  structures  as  shown 
below: 

AVE : PROC  OPTI ONS (MAIN) ; 

DECLARE  ( I NA, INB, INC) FILE  INPUT  RECORD; 

ON  ENDFILE(INA)  GO  TO  LAST; 

DECLARE  (DATAA (58)  , DATAB  (58)  , DATAC ( 58 )) FLOAT  BINARY (21)  ; 

TOP:  READ  FILE(INA) INTO (DATAA) ; 

READ  FI LE( INB) INTO (DATAB) ; 

READ  FILE ( INC) INTO (DATAC) ; 

AVG=0 . 5* DATAA (58)  +  0 . 5*DATAB ( 58)  +  0 . 2* DATAC ( 58) ; 

PUT  SKIP  L I  ST ( DATAA ( 2 )  , DATAA (5) , AVG) ; 

GO  TO  TOP; 

LAST: END  AVE; 


\ 
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U.S.  Geological  Survey 

Surface  Water  Records  in  Water-Supply  Papers 

# 

Part  10  Part  12  Part  13 


Beginning  of  record 


through  1950 

(monthly) 

1314 

1315 

1316 

1951-1960 

1734 

1736 

-  1737 

1961-1965 

1927 

19  33 

19  34 

1966-1970 

2127 

2135 

2134 

1 971 -Present 

Water 

Resources  Data 

for  Idaho. 

Part  1.  Surface  water  records. 


ILS.  Geological  Survey 

Water  Quality  Records  in  Water-Supply  Papers 
Parts  Parts  Parts  Parts 


Year 

9-14 

Year 

9-14 

Year 

9-11 

12-14 

1947 

1102 

1956 

1455 

1964 

1958 

1959 

1948 

1133 

1957 

15  23 

1965 

196  5 

1966 

194  9 

1163 

1958 

1574 

1966 

1995 

1996 

1950 

1189 

1959 

1645 

1967 

2015 

2016 

1951 

1200 

1960 

1745 

196  8 

2098 

2100 

1952 

1253 

1961 

1885 

1969 

2148 

2150 

1953 

1293 

1962 

1945 

1954 

1353 

1963 

1951 

1955 

1401 

1970- 

Present 

Water 

Resources  Data  for 

Idaho. 

Part  2.  Water  Quality  Records. 
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